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Pr©f3C© This book describes how to get an ALLBASE/SQL DBEnvironment 

up and running in the shortest possible time. ALLBASE/SQL is 
Hewlett-Packard’s relational database management system, which is 
offered on HP 3000 computers using the MPE XL operating system 
and on HP 9000 computers using the HP-UX operating system. 

This manual contains basic information about ALLBASE/SQL 
database design, creation, and administration. It is intended for new 
users of ALLBASE/SQL. Topics are discussed in separate chapters, 
as follows: 

■ Chapter 1, “Very Basic ... ,” presents basic ideas, tasks, and 
concepts. 

■ Chapter 2, “Looking at Data,” shows how to create an 
elementary database design before you create an ALLBASE/SQL 
D B Environment. 

■ Chapter 3, “Setting Up a Database with ISQL,” takes you step by 
step through the process of conhguring a DB Environment, then 
creating and loading tables. 

■ Chapter 4, “Practice with ALLBASE/SQL Using PartsDBE,” 
details the steps for setting up PartsDBE, the ALLBASE/SQL 
sample DB Environment, which is used for most of the examples in 
the ALLBASE/SQL documentation. 

■ Chapter 5, “Comparing ALLBASE/SQL with TurboIMAGE,” 
describes ALLBASE/SQL from the perspective 

of the TurboIMAGE user, maps ALLBASE/SQL 
concepts to TurboIMAGE concepts, and describes 
ALLBASE/TurboCONNECT. 

■ Chapter 6, “Glossary,” gives basic dehnitions of terms used in 
ALLBASE/SQL. 
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1 


Very Basic ... 


Before venturing into the tasks you want to accomplish with 
ALLBASE/SQL, we give a bit of thought to some basic ideas, tasks, 
and concepts: 

■ What is a database? 

■ What is a relational database? 

■ What is SQL? 

■ What is ALLBASE/SQL? 

■ What is a DBEnvironment? 

■ How do I create a DB Environment? 

■ How do I create a database? 

■ How do I access a database? 

■ How do I control database access? 

■ Where can I get help with ALLBASE/SQL? 

SQL stands for Structured Query Language, which is dehned by 
ANSI standards in the United States and by X/OPEN standards in 
Europe. In addition to standard SQL, ALLBASE/SQL uses some 
terminology of its own. A prime goal in this chapter is to provide 
you with a “working vocabulary” in both standard SQL terminology 
and the additions used by ALLBASE/SQL. If you already have 
this working vocabulary, skip ahead to the next chapter, “Looking 
at Data.” Then come back here whenever you want to review the 
basics. You can also refer to the glossary in chapter 6 for dehnitions 
of basic terms. 


What Is a 
Database? 


A database is a structured arrangement of data elements designed 
for the easy selection of information. Unlike a collection of flat hies, 
a database contains both data and structural information used in 
extracting data from the hies in which data resides. 

In ALLBASE/SQL, databases are located inside a DBEnvironment, a 
structure that is fully dehned later in this chapter. 
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What Is a Relational 
Database? 


A relational database is a collection of data arranged in tables, also 
known as relations. Tables are subject to the following relational 
operations, each of which lets you retrieve data in a specihc way: 

■ Selection, which lets you extract a subset of rows. 

■ Projection, which lets you extract a subset of columns. 

■ Joining, which lets you extract from more than one table at a time. 

In practice, these operations frequently appear together. SQL 
statements that use these operations are known as queries. Three 
queries that use the SQL SELECT command to illustrate selection, 
projection, and joining are shown in Eigure 1-1. 
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Rows and Columns 


Sample Database Table 


SELECT A,B.C.E.F 
FROM T1,T2 
WHERE A = D: 


A 

B 

C 

E 

F 

1 





3 





5 






Join 


SELECT A, B, C FROM T1 
WHERE A > 2; 


T1 


A 

B 

C 

3 



4 



5 




Selection 




D 

E 

F 

1 



3 



5 



I_ 
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A 


D 

F 

1 


3 


5 



T2 


SELECT D, F 
FROM T2; 


Projection 


PR0749-16 


Figure 1-1. Relational Operations 


When you look at data in relational terms, you can assume several 
things: 

■ Tables are arranged in rows and columns, which are like records 
and helds in an ordinary hie. 

■ Each column has a specihc data type and size. 

■ Each row contains one element for every column. 

■ A column can contain NULL values if you allow it to. 


The following is a portion of a database table consisting of names 
and account balances for an employee credit union: 


Employee Accounts 


Last Name 

First Name 

Telephone 

Employee Number 

Balance 

Harrison 

Gerald 

7233 

2432099 

142.59 

Abelson 

Annette 

4312 

3510044 

2345.09 

Stanley 

Peter 

NULL 

3540011 

321.98 

Walters 

Georgia 

2554 

9124772 

1230.10 


Notice that the third row contains a NULL value in the third column 
instead of a value for Telephone. 
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Data Types and Sizes 


Using Several Tables 


Each column can accept data of a specific type and size. Here is the 
breakdown for the sample table above: 


Column Name 

Last Name 
First Name 
Telephone 
Employee Number 
Balance 


Data Type 

VARCHAR(15) 

VARCHAR(15) 

SMALLINT 

INTEGER 

DECIMAL(10,2) 


Data types are described further in chapter 2. 


You can put the same data into several different tables such as the 
following: 


Table 1. Employees Table 


Last Name 

First Name 

Employee Number 

Harrison 

Gerald 

2432099 

Abelson 

Annette 

3510044 

Stanley 

Peter 

3540011 

Walters 

Georgia 

9124772 


Table 2. Telephone Table 


Last Name 

First Name 

Telephone 

Harrison 

Gerald 

7233 

Abelson 

Annette 

4312 

Stanley 

Peter 

NULL 

Walters 

Georgia 

2554 


Table 3. Accounts Table 


Employee Number 

Account Balance 

2432099 

142.59 

3510044 

2345.09 

3540011 

321.98 

9124772 

1230.10 


You decide which arrangements of data work best for you by using 
the processes of data analysis and database design. 
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What Is SQL? 


What Is 

ALLBASE/SQL? 


SQLCore and DBCore 


In data analysis, you investigate the various ways your data can 
be used. In database design, you create specific table structures 
based on your analysis. The design phase results in a set of table 
descriptions, sometimes known as a schema, for your database. 

Chapter 2 presents an introduction to data analysis and database 
design. 


The way into a relational database is through a query language— 
which is a set of operators, expressions, and commands that let you 
manipulate the database in various ways. You create queries as 
well as other kinds of commands in ALLBASE/SQL by using SQL 
(Structured Query Language); and you issue the commands directly, 
through an interactive command processor, or indirectly, through an 
application program. 

SQL includes commands that let you do the following: 

■ Create databases. 

■ Access databases. 

■ Provide security. 

■ Promote data integrity. 

■ Regulate concurrent access. 

SQL commands are printed in capitals (for example, SELECT) in 
this book and throughout the ALLBASE/SQL document set. 


ALLBASE/SQL is Hewlett-Packard’s proprietary relational 
database management system. Closely tuned to the architecture of 
HP computers, ALLBASE/SQL gives you enormous flexibility in 
designing and using SQL database applications on a small or large 
scale. 

ALLBASE is a family of relational database products that includes 
the components of ALLBASE/SQL and several related tools defined 
in the following paragraphs. 

Two components which together form the back end of 
ALLBASE/SQL. SQLCore accepts SQL commands and processes 
them; DBCore performs file access operations at the operating 
system level and also controls concurrent access to data, guaranteeing 
consistency. To use SQLCore and DBCore, you employ a front-end 
process, such as ISQL, ALLBASE/Query, or one of your own 
application programs. 
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ISQL 


ALLBASE/Query 


SQLUtil 


SQLGEN 


ALLBASE/4GL 


Preprocessors 


An interactive command processor which lets you enter SQL 
commands at the keyboard and observe query results, messages, 
and other information on a video display. Remember that SQL is a 
language—not a software system. So you need an interactive way to 
submit SQL commands to SQLCore and DBCore for processing. 

ISQL is the main tool used by ALLBASE/SQL programmers and 
database administrators to create and modify the schema of an 
ALLBASE/SQL DBEnvironment. It is also used by anyone who 
needs to submit queries using the SQL language. ISQL is especially 
useful for loading and unloading data. 

A screen-oriented, menu-driven approach to designing queries and 
producing quick reports from data in ALLBASE/SQL databases. 
ALLBASE/Query contains extensive online help, so it is especially 
appropriate for occasional users. 

A database administrator’s tool for displaying and setting the basic 
parameters of a DBEnvironment (explained further in the next 
section); storing and restoring DBEnvironments; setting the size 
of system buffers; and purging DBEnvironments. The database 
administrator (DBA) is the individual who creates and maintains 
objects in a DBEnvironment. SQLUtil is seldom needed by the 
ordinary user. 

A database administrator’s tool that examines the structure of a 
DBEnvironment and creates hies of SQL and ISQL commands for 
unloading it, re-creating it, and reloading it with data. The hie for 
re-creating a DBEnvironment is sometimes known as a schema. The 
schema shows you all the CREATE commands that went into the 
original development of the DBEnvironment. 

A fourth-generation programming tool. ALLBASE/4GL is a 
screen-oriented, menu-driven environment that lets you design and 
build complete ALLBASE/SQL applications without conventional 
programming. 

Tools that convert source programs containing SQL commands into 
source code that can be compiled in a programming language of 
your choice. Different preprocessors let you code applications in C, 
COBOL, EORTRAN, and Pascal. 
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ALLBASE/Net 

ALLBASE/Turbo 

CONNECT 

Other Products 


Software that permits you to set up and maintain DBEnvironments 
in networks. Through the NETUtil program, you make 
DBEnvironments on host systems available to local users. 

Software on MPE XL systems that lets you attach a TurboIMAGE 
database to a DBEnvironment and then use SQL to query the 
TurboIMAGE database as if it were a set of ALLBASE/SQL tables. 


Software that makes use of ALLBASE/SQL to meet specialized 
needs. Information Access/PC lets you access ALLBASE/SQL 
tables from your PC and integrate data from them into PC-based 
applications. Business Report Writer lets you develop complex 
reports using ALLBASE/SQL data as well as data from other 
sources. 
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What Is a 
DBEnvironment? 


In ALLBASE/SQL, you create one or more databases in a structure 
called a DBEnvironment. The structure of a DBEnvironment is 
shown in Eigure 1-2. 



The following objects are the most important parts of the 
DBEnvironment: 

■ The DBECon hie. 

■ DBEEiles. 

■ DBEEileSets. 

■ Databases. 

■ Tables and indexes. 

■ Authorities. 

■ System catalog. 

■ Log hies. 

Objects are structures created and stored in an ALLBASE/SQL 
DBEnvironment. SQLCore and DBCore connect the user interface, 
such as ISQL or an application program, with the objects of the 
DBEnvironment. 
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The DBECon File 
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To better understand the DBEnvironment and its objects, imagine 
that it is like a library, which is used to store books, periodicals, or 
other information. Like a library, the DBEnvironment is a physical 
location for information, so you need to set aside physical space for 
it. Also like a library, the DBEnvironment uses a logical method for 
storing and retrieving information. 

When you create a DBEnvironment, ALLBASE/SQL creates a 
physical hie known as the DBEnvironment Conhguration Eile or 
DBECon file. This file contains basic information that is used every 
time the DBEnvironment is opened. The DBECon file has the same 
name as the DBEnvironment itself. If the DBEnvironment is like a 
library, the DBECon file is like a building directory that points to the 
other DBEnvironment components. 
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DBEFiles 


DBEFileSets 


Databases 



You must allocate physical storage space by creating DBEFiles— 
operating system files that hold table data, index data, or both. Like 
the individual bookcases in the library, they have a specific capacity. 
DBEFiles have both physical names—operating system names— 
and logical names, by which the files are known internally to the 
ALLBASE/SQL system catalog, to be explained shortly. 


DBEFiles are grouped together in logical groupings known as 
DBEFileSets. These are something like the different subject 
categories in a library. You create a DBEFileSet with a logical name 
(this corresponds to the subject category name). Then you add 
DBEFiles to the DBEFileSet as needed, as you would add bookcases 
to the category to add more space. For example, a section may be 
labeled “Computer Periodicals” and hold many bookcases with 
different magazines in them. DBEFileSets do not have a specific 
capacity; you can always add more DBEFiles to create more space in 
them. 

The data in a DBEnvironment is stored in databases, which 
are groups of tables having the same owner. The database in a 
DBEnvironment is a bit like division ownership of certain books or 
periodicals in a library. In a university, some of the periodicals may 
belong to a computer science library, others may belong to a medical 
library, though these may be housed inside the same building and use 
the same card catalog. In such a subdivision of the library, certain 
books and periodicals could only be checked out by people belonging 
to the appropriate division or having special permission. 
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Tables and Indexes 


System Catalog 


When you create an object in the DBEnvironment, you are its owner 
by default, and therefore it belongs to your database. 

The most important objects you create are tables. The table is like 
a periodical stored in the library, and the rows in the table are like 
individual articles in the periodical. The index on a table is like the 
index to the content of a group of periodicals in the bookcase. The 
index may appear on the same shelf as the periodical or it may be 
located along with other indexes in a different bookcase. 

Tables and indexes have only logical names; a table name is like 
the title of the periodical. When you create a table, you only 
need to dehne its name and characteristics and associate it with 
a DBEFileSet. This is like adding a new periodical to a subject 
category in the library. 

More detailed information about the organization of data in tables is 
presented in chapter 2, “Looking at Data.” 

To enable readers to hnd issues of ComputerWorld, the librarian puts 
an entry in a card catalog that shows where the issues are stored. In 
the DBEnvironment, SQLCore inserts an entry in the system catalog 
for each database object you create. The system catalog is created at 
the time you create a DBEnvironment. 



The system catalog is physically located in a DBEFile known as 
DBEFILEO. This hie contains extra space for the additional entries 
that are made by SQLCore each time you create a new object. Like a 
good librarian, ALLBASE/SQL keeps the system catalog up-to-date 
for you, without your being aware of it. 

The system catalog is a set of tables for internal use by SQLCore. 
These tables are associated with a DBEFileSet known as SYSTEM. 
SQLCore uses the system catalog to look up database objects 
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Log Files 


How Do I Create a 
DBEnvironment? 
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much as you would use the card catalog in a library to look up the 
bookcase and shelf number for a book or periodical. 

ALLBASE/SQL provides logging of all transactions that take place 
in the DBEnvironment. Like the library’s record of items checked out 
and returned, the log hie is a record of the rows in database tables 
that are added, deleted, or changed. The log makes it possible to 
keep data consistent when multiple users are accessing the system, 
and it makes recovery possible in the event of a system failure. 
Information about the system log is stored in the DBECon hie. 

Because logging is essentially automatic, it will not be discussed any 
further in this book. Eor more information, you can refer to the 
chapter entitled “Backup and Recovery” in the ALLBASE/SQL 
Database Administration Guide. 


You use the SQL START DBE NEW command to create a 
DBEnvironment: 

START DBE ’DBEIame’ lEW 

Once the DBEnvironment exists, you can create databases within it. 

The START DBE NEW command lets you supply options to specify 
many of the run-time characteristics of the DBEnvironment. The 
simple form of the command shown above uses default values 
for these options. The defaults are described in detail in the 
ALLBASE/SQL Database Administration Guide chapter entitled 
“DBEnvironment Conhguration and Security.” 

When you create a DBEnvironment, you are granted the 
broadest kind of authority —permission in an ALLBASE/SQL 
DBEnvironment—to create and remove objects. This authority is 
known as DBA (database administrator) authority. 
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How Do I Create a 
Database? 


Commands to Create 
Databases 


How Do I Access a 
Database? 
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To create a database, you need to perform at least some of the 
following tasks: 

■ Create tables. 

■ Create views. 

■ Create indexes. 

These tasks are part of the data definition process, which also 
includes placing the tables in specific DBEFilesets, and using the 
SQL DROP command to remove tables or views that are no longer 
needed. 

Most data definition tasks are carried out when you are setting 
up the database for the first time. But you may need to do some 
data definition tasks later, when, for example, you need additional 
database capacity. 

You use SQL CREATE commands to create database tables and 
all the other components of a database. Each of these commands 
is shown in more detail later in this book; the following is only one 
example: 

CREATE PUBLICREAD TABLE Employees 
(Lastlame VARCHAR(15) lOT MULL, 

Firstlame VARCHAR(15) lOT MULL, 

Emplumber IITEGER lOT MULL) 

After creating a table, you use the ISQL INPUT and LOAD 
commands or an application program to put data into it. You can 
also add single rows to a table by using the SQL INSERT command. 
(These tasks are explained and illustrated in chapter 3.) 


You use the SQL CONNECT command to establish a connection to 
the DBEnvironment. You can then access a particular database as 
follows: 

■ Through ISQL. 

■ Through application programs you create yourself. 

During database access, you perform queries or other operations that 
manipulate data by inserting, deleting, or modifying rows in tables. 
This process is called data manipulation. 
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Queries and Other Data 
Manipulation 


How Do I Control 
Database Access? 


Data manipulation commands access the data in databases. An 
example is a query using the SQL SELECT command, which displays 
a selection of data from database tables. Here is a simple query for 
information from the Employees table. The asterisk means all rows 
and columns: 


SELECT * FROM Employees; 
Below is the query result: 


select * from employees; 

- + - + - 

LASTMME IFIRSTMME lEMPIUMBER 

- + - + - 


Harrison I Gerald I 2432099 
Abelson I Annette I 3510044 
Stanley iPeter I 3540011 
Walters I Georgia I 9124772 


The query result is also known as a result table. 


Other data manipulation commands include the SQL INSERT, 
UPDATE, and DELETE commands. These let you add rows to a 
table, update specihc column values in existing rows, or delete rows. 
Many examples of data manipulation are shown in later chapters. 


You use data control language to determine who has access to the 
information in a database. This is very important for security. Data 
control language confers authorities on specihc users to perform 
specihc tasks. The most powerful authority is known as DBA 
authority (database administrator authority). The DBECreator, that 
is, the person who creates a new DBEnvironment, automatically 
has DBA authority in that DB Environment. Someone with DBA 
authority can then use the GRANT command to give authorities to 
other users. The following example grants permission to update the 
Employees table to a user known as Henry: 

GRANT UPDATE ON Employees to Henry 

The controls you dehne for database security can be as simple or as 
elaborate as you wish. 


1-14 


Very Basic ... 


DRAFT 
9/12/97 20:40 





Where Can I Get 
Help with 
ALLBASE/SQL? 


Because ALLBASE/SQL has so many components and tasks, it is 
helpful to know where to hnd information about each one. Here is a 
list of the documents in the ALLBASE/SQL document set, preceded 
by a short title: 

DBA ALLBASE/SQL Database Administration Guide 

SQL ALLBASE/SQL Reference Manual 

ISQL ALLBASE/ISQL Reference Manual 

APG Eour application programming guides, which explain the use 
of the preprocessors: 

■ ALLBASE/SQL C Application Programming Guide 

■ ALLBASE/SQL COBOL Application Programming Guide 

■ ALLBASE/SQL Pascal Application Programming Guide 

■ ALLBASE/SQL EORTRAN Application Programming 
Guide 

MSG ALLBASE/SQL Message Manual 

QRG ALLBASE/SQL Quick Reference Guide 

4GL ALLBASE/fGL Documentation 

ABQ ALLBASE/Query Documentation 
NET ALLBASE/NET User’s Guide 
ATC ALLBASE/TurboCONNECT User’s Guide 

The following table shows which manuals contain information 
about each task. Part numbers for each manual appear in the 
documentation map in the front of this book. 
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Information about ALLBASE/SQL Tasks 


Task 

Title 

Section Reference 

Creating a DB Environment 

DBA 

“DBEnvironment Conhguration and Security” 

Creating, Dropping Tables 

DBA 

SQL 

“Database Creation and Security” 

“SQL Commands”—CREATE TABLE and DROP TABLE. 

Accessing Databases 

ISQL 

SQL 

ABQ 

ABC 

“Using ISQL” section on Queries 
“SQL Queries” 

All sections 

“Simple Data Manipulation” 

Granting Authorities 

SQL 

“SQL Commands”—GRANT and REVOKE. 

Loading, Unloading Data 

ISQL 

DBA 

DBA 

“Using ISQL” and “ISQL Commands”—LOAD and UNLOAD 

“Maintenance” 

“SQLGEN” appendix 

Maintaining DBEnvironments 

DBA 

DBA 

“Maintenance” 

“SQLUtil” appendix 

Migrating DBEnvironments 

DBA 

DBA 

“Tasks and Tools” 

“SQLMigrate” appendix 

Creating ALLBASE 
applications 

APG, 

4GL 

All sections 

Setting up and Using 
ALLBASE/SQL Networks 

NET 

All sections 

Setting up and Using 
TurboIMAGE Access 

ATC 

All sections 

Checking Syntax 

QRG 

All sections 

Understanding Warnings and 
Errors 

MSG 

All sections 
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This chapter presents the basic steps in data analysis and database 
design: 

■ Understanding the process. 

■ Distinguishing entities and attributes. 

■ Identifying relationships between entities. 

■ Locating distinguishing key items. 

■ Creating the table design. 

■ Dehning indexes. 

■ Dehning views. 

■ Estimating table and index size. 

■ Designing applications. 

These terms are explained as each step is discussed in the following 
sections. If you already have a table design in mind and you want to 
set it up at once, skip this chapter; come back later if you wish. But 
if you don’t know what data to put into which tables, then read on! 
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Understanding the 
Process 


A Small Sample 
Database 


Designing a database to be built with ALLBASE/SQL means 
examining the data you wish to store and then putting it into a 
form that ALLBASE/SQL can understand. In other words, you 
look at the logical relationships that exist within the data and then 
create a relational design (tables, views, indexes, etc.). The process 
can be complex, and you could use a number of formal design 
methodologies. However, you can get a good hrst approximation by 
using an intuitive approach, which is sketched very briefly in this 
chapter. 

Database design is the subject of much theoretical discussion 
and debate, but everyone agrees that good design results in good 
performance. Good database design also gives you the greatest 
flexibility in formulating your queries and in restructuring your 
databases when that becomes necessary. Eor these reasons, time 
spent on analysis and design “up front” results in time and money 
saved in developing a production system. 

A reading list at the end of this chapter provides references to 
additional information. If you are about to embark on a complex 
design, be sure to consult this material. 

To examine some data modeling techniques, let’s imagine a small 
sample database. Suppose a radio station wants to create a database 
of classical music recordings for use by program directors and 
announcers. The station needs this information to plan a schedule 
of broadcasts, to maintain a log of what is played, and to publish a 
monthly listener’s guide. Here are some specihc data items that will 
be needed: 

■ Recording company and date recorded. 

■ Album title. 

■ Album price. 

■ Medium. 

■ List of selections and timings. 

■ Total timing of each album. 

■ Names of orchestra, conductor, singers, accompanists. 

■ Composer’s name, birthplace, and dates of birth and death. 

■ Comments on composers, albums, and selections. 

■ Date, time, and announcer for each selection played. 

You can probably think of other items of information that might be 
useful (for example, the date the album was acquired), but let’s use 
these for now. How should this data be organized? 
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How Will the Data Be A typical user of the database would be the program director, who 
Used? might ask questions like the following: 

What selections do I have by Beethoven that are less than 20 
minutes long? 

What did we broadcast last year on Beethoven’s birthday? 

How many different versions of Beethoven’s Fifth Symphony do we 
have, who are the conductors, and what are the timings? 

What composers represented in our library were born in March? 

What selections did George play last Tuesday morning on his 
chamber music show? 


Distinguishing 
Entities and 
Attributes 


As you begin to design the music database, you are either creating 
a new system or you are transferring data from a non-relational 
system to ALLBASE/SQL. Regardless of where you’re coming from, 
you need to take a comprehensive look at all the information needs 
that will be served by the database system. This means identifying 
the elements for which you need to store and retrieve information. 
These elements are known as entities. A list of entities grows out of 
studying how the data is used by its owners. 


Listing EntItISS By approaching the problem intuitively, you can probably identify 

four different categories of information required by the radio station: 

■ Album information. 

■ Selection information. 

■ Composer information. 

■ Station log information. 

These are the entities in the data. 
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Listing Attributes 


Identifying 
Relationships 
between Entities 
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Next, you need to define the attributes of each entity, which are 
the useful pieces of information to be stored in tables. In addition 
to supplying informational detail, some attributes are used to 
distinguish one entity from another. As you subdivide your data, 
make sure that for each entity you define, at least one attribute can 
uniquely identify an instance of the entity. This attribute or group of 
attributes is known as a key. 


Attributes for Four Entities 


Album 

Entity 

Selection 

Entity 

Composer 

Entity 

Station Log 
Entity 

Album Name 

Medium 

Album Cost 

Recording Company 

Date Recorded 

Manufacturer’s Code 

Comment 

Selection Title 

Composer Name 
Timing 

Performers 

Comment 

Name 

Date of Birth 

Birthplace 

Comment 

Selection Title 

Start Time 

End Time 

Announcer 

Comment 


As the design evolves, entities eventually become database tables, 
and attributes eventually become columns. Note, however, that at 
this stage you have not yet identified the form of the database tables. 
Before you can do that, you need to identify relationships. 


After subdividing the data by entities, the next step of design is 
to identify meaningful relationships between the entities described 
so far. For each relationship you identify, an attribute or group of 
attributes must support the relationship. 

What are the relationships among the entities in the sample data? 

For the Album and Selection entities, there is a relationship of 
Content, that is, each album contains a specific group of selections. 
For the Composer and Selection entities, the relationship is one of 
Authorship; each composer has created one or more selections. 

Another kind of relationship exists between Selection and Composer, 
namely. Period. The attributes that define Period are the composer’s 
“Name” and “Birth Date.” 
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Locating 

Distinguishing Key 
Items 


From Entities to 
Tables 
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Each entity should have one or more attributes which can uniquely 
distinguish a particular occurrence of that entity. Each distinguishing 
attribute or group of attributes is known as a key value. Also, 
for each relationship you have dehned, an attribute or group of 
attributes should specify the relationship by forming a link between 
the entities. In the case of Station Log and Selection, the links are 
“Selection Name” and “Selection Title.” In the case of Selection and 
Composer, the link is “Composer Name,” which is an attribute of 
Composer, but would need to be added to the list of attributes for 
Selection. In the case of Album and Selection, there is a possible 
link in “Album Code,” which would have to be added to the list of 
attributes for Selection. 


Once you have added the necessary key attributes that support 
relationships, you have arrived at a set of relational tables: the 
attributes are now columns, and the key values are now key columns. 
Erom what has been done so far, you can see a set of relational tables 
emerging, as follows ( * indicates a key column): 


Columns and Keys for Four Tables 


Albums Table 

Selections Table 

Composers Table 

Log Table 

*AlbumCode 

AlbumTitle 

Medium 

AlbumCost 

RecordingCo 

DateRecorded 

MfgCode 

Comment 

*AlbumCode 

*SelectionName 
Comp oserN ame 
Timing 

Performers 

*ComposerName 

Birth 

Death 

Birthplace 

Comment 

*AlbumCode 

*SelectionName 

StartTime 

EndTime 

Announcer 


Note that the Selections and Log tables each have two key columns, 
whereas the other tables have only one apiece. Remember that a key 
must uniquely identify each entry in the table. 
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Creating the Table 
Design 


The next step is to define the characteristics of each column you have 
defined. For each potential column value, you need to answer the 
following questions: 

■ What is the data type and size? 

■ For character data, should values be fixed or variable length? 

■ Are null values allowed? 


Data Type and Size 


Some possible data types in ALLBASE/SQL are: 


CHAR 

VARCHAR 

INTEGER 

SMALLINT 

DECIMAL 

FLOAT 

DATE 

TIME 

DATE¬ 

TIME 

INTERVAL 


Fixed length character string. 

Variable length character string. 

Four-byte integer values. 

Two-byte integer values. 

Fixed-point packed decimal values. 

Floating point numbers. 

Date values. 

Clock time values. 

Timestamp values (date and time combined). 
Elapsed time values. 


Decide whether you wish to use numeric or alphanumeric (character) 
data types. If a column value needs to participate in arithmetic 
operations, it should be either a numeric or date/time data type. 


Make sure that your data types are consistent from table to table 
where columns are to be joined. For example, when you want to 
look up all the selections for a specific album title, the AlbumCode 
column in the Albums table must be consistent with the AlbumCode 
column in the Selections table. If it is not, you may not get all the 
data you expect. 


Charactsr Data in the case of character data, decide whether the type should be fixed 
length (CHAR) or variable length (VARCHAR). When a character 
column will contain values of uniform size, such as two-character 
alphabetic codes, use CHAR. If the size of values is not expected 
to be uniform, use a VARCHAR type, and specify the expected 
maximum size. 


NULL Values Consider whether or not information will be available when deciding 
whether to permit NULL values. A NULL value is the absence of 
data for a specific column. For example, you might permit NULL 
values in the ComposerName column of the Selections table, because 
a selection may be anonymous; but you should not permit the 
ComposerName column in the Composers table to be NULL. 


Not6 ™| Key columns should never be NULL. 
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Modifying the Table 
Design 


Table Descriptions 


One further consideration: Is all the data within a particular entity 
accessed at the same time? If not, it may be wise to consider 
subdividing as you convert the entity into a table description. You 
might move some of the information in the Albums table to a 
different table if it is not used very often. 

A related consideration: Is some of the data from two or more tables 
always accessed together? In this case, consider combining two 
tables into one. For example, you might include AlbumCode and 
AlbumTitle in the Selections table if these data items are always 
included with other data about selections. 

The formal term for modifying the table design by examining the 
relationships among columns is called normalization, which is 
described in the “Logical Design” chapter of the ALLBASE/SQL 
Database Administration Guide. Also, refer to the list of references at 
the end of this chapter. 

When you have made decisions on these issues, you can create a 
description of each table, as follows: 


Albums Table 


Table Name 

Column Name 

Data Type 

NOT NULL 

Size 

Albums 

AlbumCode 

INTEGER 

NOT NULL 

4 bytes 


AlbumTitle 

VARCHAR(40) 


40 bytes 


Medium 

CHAR(2) 


2 bytes 


AlbumCost 

DECIMAL(6,2) 


4 bytes 


RecordingCo 

CHAR(IO) 

NOT NULL 

10 bytes 


DateRecorded 

DATE 


16 bytes 


MfgCode 

VARCHAR(40) 


40 bytes 


Comment 

VARCHAR(80) 


80 bytes 


Titles Table 


Table Name 

Column Name 

Data Type 

NOT NULL 

Size 

Selections 

AlbumCode 

INTEGER 

NOT NULL 

4 bytes 


Selection 

VARCHAR(40) 

NOT NULL 

40 bytes 


Comp oserN ame 

VARCHAR(16) 


16 bytes 


Timing 

INTERVAL 


16 bytes 


Performers 

VARCHAR(40) 


40 bytes 


Comment 

VARCHAR(80) 


80 bytes 
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Composers Table 


Defining Indexes 
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Table Name 

Column Name 

Data Type 

NOT NULL 

Size 

Composers 

Comp oserN ame 

VARCHAR(16) 

NOT NULL 

16 bytes 


Birth 

DATE 


16 bytes 


Death 

DATE 


16 bytes 


Birthplace 

VARCHAR(40) 


40 bytes 


Comment 

VARCHAR(80) 


80 bytes 


Log Table 


Table Name 

Column Name 

Data Type 

NOT NULL 

Size 

Log 

AlbumCode 

INTEGER 

NOT NULL 

4 bytes 


SelectionName 

VARCHAR(40) 

NOT NULL 

40 bytes 


StartTime 

DATETIME 

NOT NULL 

16 bytes 


EndTime 

DATETIME 

NOT NULL 

16 bytes 


Announcer 

VARCHAR(40) 

NOT NULL 

40 bytes 


The sizes shown here are taken from the ALLBASE/SQL Database 
Administration Guide chapter on “Physical Design.” 


After you have designed the structure of the tables in the database, 
consider which columns are good candidates for the creation of 
indexes. An index is an object which you create after creating the 
table. It is not absolutely necessary to create an index on a table, 
but doing so can help ALLBASE/SQL point more quickly to the 
row you need. For example, in the Albums table, you might consider 
creating a unique index on the AlbumCode column, because using a 
unique index may allow SQLCore to arrive at the required row more 
quickly than by doing a scan of every row in the table. Also, the 
unique index guarantees that the AlbumCode is a unique number. 

Suppose your application prints the album titles of all the albums 
containing selections by a specihc composer. This requires a join 
between the Albums table and the Titles table. The join might be 
slow to execute because, hrst, ALLBASE/SQL would have to search 
every row of the Titles table to hud the entries for the composer. 

Then it would have to search every row of the Albums table to hud 
every match with the album code found in the Titles table along 
with the composer’s name. The join column in this query is the 
AlbumCode column; if you create an index on the AlbumCode 
column of each table, the query might execute faster. 

Furthermore, the AlbumCode column in the Albums table would be 
a good candidate for creation of a unique index, because the value in 
this column should not be duplicated. In the case of the Titles table, 
the index should not be unique, because the table can have many 
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rows with the same album code. That is, an album can contain many 
selections. 


Some tables may also be good candidates for creation as 
hash structures, which are essentially self-indexed. For more 
information on this topic, refer to the chapter “Using SQL” in the 
ALLBASE/SQL Reference Manual. 


Designing Database 
Security Schemes 


You can provide security for data at the level of the DBEnvironment 
itself, or at the level of individual tables. At the DBEnvironment 
level, you can provide CONNECT authorization to just those users 
who need access. 

ALLBASE/SQL also has several kinds of TABLE authorities, so that 
you can control the kind of access that is possible for different users 
of each column in each table. For each table, you should ask the 
following questions: 

Which users need to SELECT? 

Which users need to add new rows or delete existing rows? 

Which users need to modify existing rows? 

You can classify the users with similar needs by creating a group 
and then adding those users to it. Make a list of the user groups you 
need to accomodate in the security design. For example, the Music 
database might have the following groups and authorities: 


Group Name 

Type of Authority 

Managers group 

Announcers group 

Librarians group 

ALL authorities on all tables 

INSERT authority on Log table, SELECT on others 

ALL authorities on Albums, Titles, and Composers tables 


After creating groups, you can grant and revoke authorities to 
individual users or groups for each table. 

Do some tables require general access for most columns but restricted 
access for some? For these, you can create views, which can be made 
available to all users while the base table is restricted to those with a 
need to manipulate all columns. 
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Estimating Table 
and Index Size 

■ 

In order to implement your table design, you need to estimate the 
amount of disk space required for your tables and any indexes you 
plan to create. Then, when you create DBEFiles to contain the data, 
specify a size that is big enough to hold the rows you want to store 
plus some room for growth. 


The tutorial in chapter 3 uses hie sizes that are more than adequate 
for the sample database you are creating. Before creating a large 
database, calculate your space requirements carefully. Complete 
information about size calculation for tables and indexes is given 
in the “Physical Design” chapter of the ALLBASE/SQL Database 
Administration Guide. 

Designing 

Applications 

■ 

Once your table design is complete, you can begin to design your 
applications in detail. At this point, you may need to modify the 
table design to improve performance. Keep in mind, however, that 
later applications may need to use the same data in very different 
ways. Therefore, table design should remain somewhat independent 
of application design. 

Further 

Information ... 

■ 

Database design is complex. The foregoing discussion oversimplihes 
many aspects of good design in the interest of getting you started. 

For a major production system, you need to study your data 
carefully and plan your tables accordingly. 


Here are the titles of some recommended readings for additional help 
in designing your databases: 


■ Atre, Shaku. Database: Structured Techniques for Design, 
Performance, and Management. New York: John Wiley & Sons 

Inc., 1988. 


■ Date, Chris. “A Practical Approach to Database Design,” 
in Relational Database: Selected Writings. Menlo Park, CA: 
Addison-Wesley Publishing Co., Inc., 1986. 


■ Loomis, Mary E. S. The Database Book. New York: Macmillan 
Publishing Company, 1987. 


■ Turk, Thomas A. “Using Data Normalization Techniques for 
Effective Data Base Design,” .Journal of Information Systems 
Management, Winter 1985. 


Also, refer to the “Logical Design” and “Physical Design” chapters in 
the ATTBASE/SQT Database Administration Guide. 
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Setting Up a Database with ISQL 


Running ISQL 
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This chapter is a tutorial on setting up your own database using 
ISQL, the interactive component of ALLBASE/SQL. The tutorial 
takes you through the steps you need to follow in creating any 
ALLBASE/SQL database, large or small. 

Here are the steps: 

■ Running ISQL. 

■ Creating a DBEnvironment. 

■ Creating DBEEileSets. 

■ Creating DBEEiles for table and index data. 

■ Adding DBEEiles to DBEEileSets. 

■ Creating tables. 

■ Entering data into tables. 

■ Performing queries. 

■ Creating views. 

■ Granting authorities. 

■ Creating an index. 

■ Examining the system catalog. 

The example chosen to illustrate these steps is a database of 
information about record albums. This database uses the tables 
described in chapter 2, “Looking at Data.” Eollow the steps yourself 
on a system in an empty group (MPE XL) or directory (HP-UX). 


Before you can create a new DB Environment, you must run ISQL by 
simply entering 

isql [Return") 

at your operating system prompt. ALLBASE/SQL then displays the 
ISQL banner as in Eigure 3-1 (some details may be slightly different 
on your system): 
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Figure 3-1. ISQL Banner 

You should make a note of two things before going any further: 

■ You must always use a semicolon and press f Return ] to terminate a 
command in ISQL. 

■ You leave ISQL by typing 

isql=> exit; [Return") 

If ISQL asks whether or not you want to commit work, you must 
reply either Y or N and press f Retum "). A Y makes the work you 
have done permanent. 


Creating a 
DBEnvironment 


If you exited from ISQL, you must run ISQL again. Then, to create a 
new DBEnvironment, use the START DBE NEW command at the 
ISQL prompt, as follows: 

isql=> START DBE ’MUSICDBE’ lEW; fRihihri 

If you forget to use the semicolon, a continuation prompt appears: 

> 

Simply type a semicolon and press f Retum ] . After a brief interval, you 
will see the ISQL prompt return. That’s it! You have created a new 
DBEnvironment named MUSICDBE. 

Exit from ISQL as explained in the previous section. Use an 
operating system command to display the hies in your current group 
or directory. Notice three newly created hies: 

■ MUSICDBE. 
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■ DBEFILEO. 

■ DBELOGl. 


DBECon Fil© The first of these is the DBECon file or DBEnvironment 

configuration file. This has the same name you assigned to the 
DBEnvironment in the START DBE command. The DBECon file 
contains startup parameters for the DBEnvironment. Eor complete 
information about startup parameters, refer to the “DBEnvironment 
Configuration and Security” chapter of the ALLBASE/SQL Database 
Administration Guide. 

DBEFilsO DBEEILEO is a file containing the data for the SYSTEM 

DBEEileSet, which contains the system catalog. (You’ll examine the 
system catalog later.) 


L09 Fil© DBELOGl is the log file, which records operations that modify the 
database in any way. The log file is not discussed further here. Eor 
more information, refer to the “Backup and Recovery” chapter in the 
ALLBASE/SQL Database Administration Guide. 

Eor more information on configuring a DBEnvironment, refer to the 
entry for START DBE NEW in the “SQL Commands” chapter of 
the ALLBASE/SQL Reference Manual. This entry describes all the 
default configuration values used in creating MUSICDBE. 


Creating 

DBEFileSets 


Before you can create tables and load data into a database, you 
need to provide physical file space. Physical files are known as 
DBEFiles, and they are grouped together in logical groupings called 
DBEFileSets. 

After the last step, you exited from ISQL, so you must run 
ISQL again and connect to the newly created DBEnvironment 
MUSICDBE. From the ISQL prompt, issue the following commands: 

isql=> COIIECT TO ’MUSICDBE’; (Rihihl'l 

Then use the following command to create a new DBEEileSet— 
ALBUMFS: 

isql=> CREATE DBEEILESET AlbumFS; (Rihihl'l 

Do not forget the semicolon. 


Not© I ALLBASE/SQL upshifts the logical names of objects like ALBUMFS 
in the previous example. Thus, even though you enter them in mixed 
case (as shown above), they will appear in the system catalog as all 
uppercase. (We’ll see an example later.) 

MPE XL also upshifts all physical file names. Thus, the names of 
DBEFiles, log files, and DBECon files (including MUSICDBE in the 


DRAFT 

9/12/97 20:40 


Setting Up a Database with ISQL 3-3 



previous example), all appear as uppercase in directory displays in 
MPE XL, regardless of whether you entered these names in upper, 
lower, or mixed case. HP-UX does not upshift hie names, so they 
appear in directory displays exactly as you enter them. Rembember 
that in the CONNECT statement, the name of the DBEnvironment 
is case-sensitive in HP-UX, but it is not case-sensitive in MPE XL. 


Creating DBEFiles 
for Table and Index 
Data 


Next, you can create DBEEiles of three different types—TABLE, 
INDEX, and MIXED. In most cases, it is wise to prepare separate 
DBEEiles for table data and for indexes, so you will create two 
DBEEiles—AlbumTables and Albumindex. (In a later step, you will 
associate these DBEEiles with the DBEEileSet ALBUMES.) Eirst, 
type the following command: 

isql=> CREATE DBEFILE AlbumTables [Return ") 

> WITH PAGES=50, (Rihihl") 

> IAME=’ALBUMD1’ , TYPE=TABLE; (Rihihl") 

This command creates a new DBEEile known internally to 
ALLBASE/SQL as AlbumTables and to the operating system as 
ALBUMDl. The hie contains hfty 4096-byte pages, and is available 
for storage of table data only. 
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Now issue the next command: 
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isql=> CREATE DBEFILE Albumindex f Return ~) 

> WITH PAGES=30, (r^I 

> MME=’ALBUMI1’ , TYPE=IIDEX; (r^I 

This command creates a new DBEFile known internally to 
ALLBASE/SQL as Albumindex and to the operating system as 
ALBUMIl. This hie contains thirty 4096-byte pages, and is available 
for storage of indexes only. 


Notes The third DBEFile type—MIXED—can store both tables and 

ijP indexes. DBEFILEO is an example of a MIXED DBEFile. 

DBEFILEO, which belongs to the DBEFileSet known as SYSTEM, 
was created at the time you issued the START DBF NEW command. 
You can create new DBEFiles and add them to SYSTEM. 

If you do not specify a DBEFileSet when you create a table, it is 
stored in the SYSTEM DBEFileSet by default. However, since 
SYSTEM is already in use with system information, it is better to 
use separate DBEFileSets and DBEFiles for your data. You’ll be 
creating a table in AlbumFS in the next few sections. 


CommittinQ Work Did all three commands complete without any error messages? If so, 

issue the following command: 

isql=> COMMIT WORK; (Rihihl'l 

Committing work is necessary because ALLBASE/SQL processes 
commands in units known as transactions. When you issue the 
hrst SQL command in a sequence, a transaction begins, and 
that transaction continues until you do a COMMIT WORK or 
ROLLBACK WORK. The use of transactions guarantees the 
consistency of data within the DBEnvironment. 


Note If you received an error message saying that your transaction was 

rolled back, you should review what you have done, to see if you 
can spot the error. When you are ready, go back to the CREATE 
DBEFILESET command above and try again. If the hies ALBUMDl 
or ALBUMIl exist, use an operating system command to erase them 
from the current working directory or group before attempting to 
issue the CREATE DBEFILE commands again. 
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Adding DBEFiles to 
DBEFileSets 


After creating DBEFiles, you must add them to a DBEFileSet before 
they can be used. In MUSICDBE, two choices are available: 

■ SYSTEM, already created when you issued the START DBF 
command. 

■ ALBUMFS, which you created in an earlier step. 

Use the following commands to add your DBEFiles to DBEFileSet 
ALBUMFS: 

isql=> ADD DBEFILE AlbumTables f Return ] 

> TO DBEFILESET ALBUMFS; fRihihri 
isql=> ADD DBEFILE Albumindex f Return ] 

> TO DBEFILESET ALBUMFS; fRihihri 
isql=> COMMIT WORK; fRihihl'l 

Don’t forget to COMMIT WORK! 


Creating Tables 


Now get ready to create some tables for MUSICDBE. Before doing 
this step, you need to analyze the data that is to be stored. In the 
next paragraphs, assume that, using the suggestions in chapter 2, you 
have already arrived at the following table design: 


Albums Table 


AlbumCode INTEGER NOT NULL 

AlbumTitle VARCHAR(40) 

Medium CHAR(2) 

AlbumCost DECIMAL(6,2) 

RecordingCo CHAR(IO) NOT NULL 

DateRecorded DATE 

MfgCode VARCHAR(40) 

Comment VARCHAR(80) 


Titles Table 


AlbumCode 

Selection 

Timing 

Composer 

Performers 

Comment 


INTEGER NOT NULL 

VARCHAR(40) NOT NULL 

INTERVAL 

VARCHAR(40) 

VARCHAR(40) 

VARCHAR(80) 


Now, you need to create each of these tables. 
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Crsating th© Albums Use the following command to create the Albums table: 

Table isql=> create public table Albums (Rihlhll 

> (AlbumCode INTEGER MOT MULL, [Return"] 

> AlbumTitle VARCHAR(40) lOT MULL, (Rihlhll 

> Medium CHAR(2) , [Return ] 

> AlbumCost DECIMAL (6,2) , [Return ] 

> RecordingCo CHAR(IO) lOT MULL, fRihlhll 

> DateRecorded DATE, f Return ~) 

> MfgCode VARCHAR(40) , [Rihlhll 

> Comment VARCHAR(80)) [Return ^ 

> IM ALBUMFS; [Rihlhll 

Did the command complete without errors? If not, did you do the 
following: 

■ Use a semicolon at the end? 

■ Include a hnal close parenthesis? 

■ Use valid data types and sizes? 

Use the ISQL REDO command to examine and correct your 
command, then issue it again. (For help with REDO, type HELP 
REDO at the isql=> prompt. 

When the command completes without errors, use the COMMIT 
WORK command to make it permanent. 


Note 



You created the Albums table as a PUBLIC table, which means that 
other users of the DBEnvironment need no special authorization to 
access the table. 


Creating the Titles 
Table 


Now, create the second table: 

isql=> CREATE PUBLIC TABLE Titles [Rihihi'l 

> (AlbumCode INTEGER MOT MULL, [Return") 

> Selection VARCHAR(40) lOT MULL, [Rihihi'l 

> Composer CHAR(40), f Return ~) 

> Timing INTERVAL, f Return ~) 

> Performers VARCHAR(40), [Return ] 

> Comment VARCHAR(80)) [Return ") 

> IM ALBUMFS; [Rihihil 

If the command completes without errors, use the COMMIT WORK 
command. 
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Entering Data into 
Tables 


Entering Data with the 
SQL INSERT Command 


Once you have created tables, you can get data into them in several 
ways. Try the following two methods: 

■ The SQL INSERT command. 

■ The ISQL LOAD command. 

Use the SQL INSERT command to add rows to the tables you have 
created. Try the following entry for the Albums table: 

isql=> INSERT INTO Albums f Retum ] 

> VALUES (2001, fRihlhn 

> ’Serenades from the 17th Century’, f Retum] 

> ’ca’ , 30.82, f Retum^ 

> ’philips’, ’1988-12-18’, fRihlhr) 

> ’3456-AB-0998LS’, fRihlhl'l 

> ’Authentic original instruments’); f Retum] 

If the command does not complete successfully, check all your 
punctuation carefully, and try again. When hnished, COMMIT 
WORK. 

Next, use the INSERT command to add the following row to the 
Titles table (you need to build the INSERT command yourself): 

AlbumCode: 2001 
Selection: ’La Bella Musica’ 

Composer: ’Palestrina’ 

Timing: ’0 00:21:12.000’ 

Performers: ’Ancient Music Group’ 
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Comment: ’Lute improvisations’ 

Note that INSERT is an SQL command that processes a single row 
of data at a time. If you want to insert many rows at a time, use an 
application program of your own design, or else try the ISQL LOAD 
command, explained below. 


EntsrinQ Data with th© Use the ISQL LOAD command to insert data from an ordinary hie 
ISQL LOAD Command your tables. Two kinds of LOAD operation are possible: 

■ LOAD INTERNAL. 

■ LOAD EXTERNAL. 

The next sections show an example of each. 


Note 



The sample external and internal hies described in the next few 
paragraphs are available on MPE XL 3.0 or later systems and on 
HP-UX 8.0 or later systems. If you are using an earlier version 
of ALLBASE/SQL, you should skip ahead to the section entitled 
“Performing Queries.” 


LOADing from an INTERNAL File 

You use the LOAD command with the INTERNAL option to 
load data from a hie in INTERNAL format previously created 
by ISQL’s UNLOAD command. Your system contains an 
INTERNAL hie with data for the Titles table. In MPE XL, 
it is called TITLE.SAMPLEDB.SYS; in HP-UX, it is called 
/usr/lib/allbase/hpsql/sampledb/title. Erom ISQL, issue the 
apppriate command for your system: 

On MPE XL: 

isql=> LOAD FROM IITERIAL [Return"] 

> TITLE.SAMPLEDB.SYS 

> TO Titles; f Retum^ 

On HP-UX: 

isql=> LOAD FROM IITERIAL ("Return"] 

> /usr/lib/allbase/hpsql/sampledb/Title [Return ] 

> TO Titles; f Retum^ 

As loading progresses, messages tell you how many rows have been 
processed. 


Not© ™| If you are loading a large hie, be sure to set ISQL’s AUTOCOMMIT 
y function to ON. Tor information, type HELP SET AUTOCOMMIT 
at the ISQL prompt. Eor the present examples, AUTOCOMMIT is 
not needed. 
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LOADing from an EXTERNAL File 

Use the LOAD command with the EXTERNAL option to load data 
from plain ASCII hies into a table. You must enter the names of the 
columns in the table you are loading into and the starting location 
in the hie where each data item starts, together with the data item’s 
length. If the column permits null values, the data hie must contain 
null indicator characters for any entry that is null. In the following 
example, the question mark (?) is used as a null indicator. 

Erom ISQL, issue one of the following commands, as appropriate for 
your system. Be sure to type exactly. 

On MPE XL: 

isql=> LOAD FROM EXTERIAL (Rihihl'l 

> ALBUM. SAMPLEDB .SYS to Albums (Rihihl'l 

> AlbumCode 1 4 [Return ") 

> AlbumTitle 13 40 [Return ^ 

> Medium 53 2 ? [Return ") 

> AlbumCost 55 6 ? [Return ^ 

> ReCOrdingCo 61 10 [Return ") 

> DateRecorded 71 10 ? [Return ") 

> MfgCode 89 40 ? [Return ^ 

> Comment 137 80 ? [Return ^ 

> END; (Return)) 

On HP-UX: 

isql=> LOAD FROM EXTERNAL (Rihihl") 

> /usr/lib/allbase/hpsql/sampledb/Album f Retum) 

> to Albums fReturn") 

> AlbumCode 1 4 [Return ") 

> AlbumTitle 13 40 [Return ^ 

> Medium 53 2 ? [Return ") 

> AlbumCost 55 6 ? [Return ^ 

> ReCOrdingCo 61 10 [Return ") 

> DateRecorded 71 10 ? [Return ") 

> MfgCode 89 40 ? [Return ^ 

> Comment 137 80 ? [Return ^ 

> END; (Return)) 

After you have entered the column descriptions, ISQL prompts you 
as follows: 

Load depending on value in input record (Y/N)> 

Reply N to load all the values in the hie. When the command 
completes, issue a COMMIT WORK command: 

isql=> commit work; [Return ") 

Note that the starting columns for each held of data are determined 
by the actual position of the data in the hie itself. Thus, using 
EXTERNAL hies, it is possible to load selected parts of each record. 
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For complete information about loading tables from INTERNAL and 
EXTERNAL files, refer to the ALLBASE/ISQL Reference Manual. 


Performing Queries 


After loading your tables, you are ready to perform some queries to 
see the result of your efforts at data dehnition and data entry. Use 
the SELECT command to display the information you need. 

The simplest form of SELECT uses the asterisk (*) to indicate that 
you want to retrieve all the rows and columns in the table: 

isql=> SELECT * FROM Titles; [Return ") 

This command retrieves all columns for all rows in the Titles table. 

You can add a predicate (a WHERE clause) to narrow the range 
of rows selected to a specihc subgroup. In the following example, 
the predicate evaluates a column in the table (Composer) against a 
constant value (’Palestrina’): 

isql=> SELECT * FROM Titles [Return ") 

> WHERE Composer = ’Palestrina’ ; [Return ") 

This retrieves all rows in the Titles table whose composer is 
Palestrina. 

You can use a column list to narrow the range of columns selected to 
a specihc group: 

isql=> SELECT AlbumTitle, [Return ") 

> AlbumCost from Albums [Return ") 

> WHERE Medium = ’cd’; [Return ") 

A query that retrieves information from more than one table is 
known as a join. In a two-table join, at least one predicate evaluates 
a column in the hrst table against a column in the second. For 
example, the following join query displays all album titles and 
selections that have the same album code, drawing on the rows in 
both the Albums and the Titles tables: 

isql=> SELECT AlbumTitle, Selection [Return ") 

> FROM Albums, Titles WHERE [Return ") 

> Albums . AlbumCode = Titles .AlbumCode; [Return ") 

Notice that the AlbumCode column has to be qualihed by its 
table name because it appears in both tables. For additional 
information about queries, refer to the “SQL Queries” chapter of the 
ALLBASE/SQL Reference Manual. 
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Creating Views 


Granting Authorities 


When you need to perform a query frequently, you can define a view 
that incorporates the column list and the predicate; then you can 
select from the view with a simpler command. 

As an example, create a view of the Albums and Titles tables that 
includes all selections: 

isql=> CREATE VIEW Selections AS f Retum] 

> SELECT AlbumTitle, Selection, f Retum] 

> Composer FROM Albums, Titles f Retum] 

> WHERE Albums . AlbumCode = f Retum ] 

> Titles .AlbumCode; f Retum ~) 

Now use the following simple SELECT statement to display all 
selections by Palestrina: 

SELECT * FROM Selections f Retum] 

> WHERE Composer = ’Palestrina’ ; f Retum] 

Views are useful when you want to dehne specihc subsets of data 
that are frequently used or when you want to restrict access to 
particular subsets. You can create views and grant access to them, 
then revoke access to the underlying base tables. 

Did you remember to COMMIT WORK? This makes the view 
dehnition permanent in the DBEnvironment. 

Eor more information about views, see the CREATE VIEW 
command in the “SQL Queries” chapter of the ALLBASE/SQL 
Reference Manual. 


Because you created MUSICDBE, you have DBA (database 
administrator authority), which lets you grant authorities to other 
users. In a simple authorization scheme, you hrst grant CONNECT 
authorization to permit access to the DBEnvironment itself. Then 
you grant table authorities to specihc users or groups of users. You 
can also include the special user PUBLIC, which includes anyone 
who has the authorization to CONNECT to the DBEnvironment. 
Use the following commands to create an authority scheme for two 
groups of users, announcers and librarians, while excluding all others 
(PUBLIC). 
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isql=> CREATE GROUP Librarians; f Return) 
isql=> ADD Ann, Peter TO [Return ") 

> GROUP Librarians; ( Return ") 

isql=> CREATE GROUP Announcers; f Return) 
isql=> ADD Fred, Julia TO (Return) 

> GROUP Announcers; ( Return ") 
isql=> GRAIT COIIECT TO 

> Announcers, Librarians; [Return) 
isql=> GRANT ALL ON Albums f Return) 

> TO Librarians; [ Return") 

isql=> GRANT ALL ON Titles f Return) 

> TO Librarians; [ Return") 

isql=> GRANT SELECT ON Albums [r^") 

> TO Announcers; [ Return ") 

isql=> GRANT SELECT ON Titles [r^") 

> TO Announcers; [Return ") 

isql=> REVOKE ALL ON Albums [Return ") 

> FROM PUBLIC; 

isql=> REVOKE ALL ON Titles [Return ") 

> FROM PUBLIC; 

Because you created these tables as PUBLIC (shareable by everyone) 
in an earlier step, you need to remove authorities from PUBLIC. This 
is the normal procedure for tables that will have restricted but still 
multi-user access in the DBEnvironment. 

You can also use views to provide restricted access to portions of 
tables. After creating the view, you can grant access on it to a 
specihc user or group: 

isql=> GRANT SELECT ON Selections TO PUBLIC; fRihihr) 


Cr@3tin9 sn lnd@X You can speed up access to data by providing indexes on specihc 

columns in your tables. Assuming your tables are large enough, an 
index scan will arrive at a specihc row more quickly than a serial 
scan. When an index is used, ALLBASE/SQL looks for an entry 
in the index hrst, then goes to the row. When a serial scan is used, 
ALLBASE/SQL reads from the beginning of the table until the 
desired row is reached. Naturally, the use of the index is faster if you 
only need a small subset of rows. 

You can also use an index to guarantee the uniqueness of specihc 
column values. In the Albums table, for example, the AlbumCode 
column should be unique; in the Titles table, it should not be unique, 
because a single album may contain several selections. 

Create a unique index on the AlbumCode column of the Albums 
table with the following command: 
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isql=> CREATE UIIQUE IIDEX AlbCodelndex [Return) 

> 01 ALBUMS (AlbumCode); 

Use the following command to create a non-unique index on the 
AlbumCode column of the Titles table: 

isql=> CREATE INDEX TitleCodeIndex f Return ~) 

> ON TITLES (AlbumCode); fRihlhl'l 

Location of Tablos and Each index is created in the same DBEFileSet as the table it 
IndOXOS indexing. These two indexes are created in the DBEFileSet 

ALBUMFS, and they are physically located in the INDEX DBEFile 
created for that DBEFileSet in an earlier step. 
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As shown in the illustration, indexes and tables always appear in the 
same DBEFileSet (shelf area). They may be in different DBEFiles, 
however. 



PR0749-06-01 


Note 



When you issue a query, you do not tell ALLBASE/SQL to use an 
index. Instead, the SQLCore optimizer decides when the use of an 
existing index is the best way to access a specihc set of data. 


For more information about indexes, refer to the discussion 
of “Providing Data Access Paths” in the chapter “Using 
ALLBASE/SQL” of the ALLBASE/SQL Reference Manual. Also, 
see the CREATE INDEX command in the “SQL Commands” 
chapter of the ALLBASE/SQL Reference Manual. 
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Examining the 
System Catalog 


Whenever you create objects in ALLBASE/SQL, their characteristics 
are stored in the system catalog, which is a special system-created 
database. The system catalog is like a listing of the contents of a 
DBEnvironment. (See the illustration below.) 



You can look at the system catalog by performing queries on system 
tables. Issue the following query to see entries for the tables and 
views you have just created: 

isql=> SELECT * FROM SYSTEM.TABLE (Rihjhjl 
> WHERE OWNER = USER; (Rihjhjl 

The next hgure shows the hrst display you see. 
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Enter “r” to scroll right to see all the columns. A complete 
description of each column appears in chapter 9 of the 
ALLBASE/SQL Database Administration Guide. For now, notice the 
value in the TYPE column. A zero (0) indicates a table, a one (1) 
indicates a view. 


Updating Statistics in Use the UPDATE STATISTICS command for each table as follows: 

the System Catalog isqi=> update statistics for table albums; 

isql=> UPDATE STATISTICS FOR TABLE TITLES; 

This ensures that the current number of rows in each table and 
other statistical information are updated in the system catalog. The 
statistical information is used by SQLCore when it decides whether 
to use an index or not. Statistics also provide information about 
ongoing processes within the DBEnvironment. 
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In Review ... 


In this tutorial chapter, you created a default DBEnvironment 
structure consisting of a DBECon hie, a log, and a DBEEILEO 
associated with DBEEileSet SYSTEM to contain system catalog 
data. You created the ALBUMES DBEEileSet, and two DBEEiles 
associated with it—AlbumData, for the Albums and Titles table 
data, and Albumindex, for the Albums and Titles indexes. You also 
created and loaded the tables themselves, created groups and granted 
authorities, and dehned a unique and a non-unique index. You have 
also done several queries and examined the system catalog. 

As a further exercise, create the Composers and Log tables from 
the descriptions in chapter 2. Consider whether to create indexes 
on them. Add some rows to them, using values consistent with the 
entries in the Albums and Titles tables. Then perform some queries. 
What sort of security structure would be appropriate? 

There’s plenty more! But you’re off to a good start. As you 
continue with your own DB Environments, use the examples in 
the ALLBASE/ISQL Reference Manual and the ALLBASE/SQL 
Reference Manual as models. You can also refer to the chapter in 
this guide entitled “Practice with ALLBASE/SQL Using PartsDBE” 
for information about a comprehensive sample DBEnvironment that 
is supplied as a part of ALLBASE/SQL. 
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Practice with ALLBASE/SQL Using PartsDBE 
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The ALLBASE/SQL software includes a sample DBEnvironment 
known as PartsDBE and a set of sample application programs which 
illustrate much of the functionality of ALLBASE/SQL. Most of the 
examples in the ALLBASE/SQL documentation use PartsDBE. This 
chapter shows you how to get practice using the components of 
ALLBASE/SQL by creating a version of PartsDBE which you can 
use to try out the examples on your own system. 
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Setting up PartsDBE 


Using SQLSetup 


Here are the topics covered: 

■ Setting up PartsDBE. 

■ Examining PartsDBE. 

■ Using the preprocessors. 

■ Examining startup parameters with SQLUtil. 

■ Creating a schema hie with SQLGEN. 

■ Purging PartsDBE. 


Before beginning, change into the group and account or directory 
where you want to create PartsDBE. Use an empty group or 
directory if possible. Then choose one of the following two methods 
for setting up PartsDBE: 

■ Using SQLSetup. 

■ Using setup scripts. 

SQLSetup is a sample database setup tool which simplihes the 
process of installing PartsDBE in your work space. B is available 
on MPE XL 3.0 and later systems, and on HP-UX 7.08 and later 
systems. B you are using a system prior to HP-UX 7.08 or MPE XL 
3.0, use the setup procedure described under “Using Setup Scripts.” 

Run SQLSetup by issuing the proper command for your system: 

HP-UX: 

$ csh /usr/lib/allbase/hpsql/sqlsetup [Return") 


MPE XL: 

: SQLSETUP.SAMPLEDB.SYS fRihihri 

A menu like the one in Eigure 3-1 appears on your screen (some 
details may differ on your system). 
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Choose 


one: 


1. Crec 

2. Crec 

3. Cop3 

4. Gene 

5. Disj 

6. Pur| 

7. Hell 
0. ExH 


e PartsDBE without sample programs 

e PartsDBE, copy, preprocess and compile sample programs 
preprocess and compile sample programs only 
rate a schema for PartsDBE 
lay schema for PartsDBE 
e PartsDBE and sample programs 



Figure 4-1. SQLSetup Menu 

From this menu, you select an option to create a copy of PartsDBE 
in your directory (HP-UX) or group and account (MPE XL). Before 
choosing an option, examine each line on the menu. The hrst option 
simply creates a copy of PartsDBE. The second option, in addition 
to creating PartsDBE, copies a set of application programs into the 
current directory or group, then preprocesses and compiles them. 
(This is time-consuming.) 

Option 3 creates just the sample program set. Option 4 creates a 
schema with SQLGEN. Option 5 displays the schema once it has 
been created. Option 6 lets you purge the sample DBEnvironment 
and programs. 

Choose the Help option to see more information about SQLSetup, or 
choose 0 to exit. 

Creating PartsDBE 

Choose option 1 from the SQLSetup menu. This option runs a set of 
ISQL command hies that create the DBEnvironment, dehne all its 
tables, views, indexes and security structure, and then load it with 
data. 

As the system creates PartsDBE, you see several messages displayed. 
At the end of the creation process, you see the following message: 

Creation and Loading of PartsDBE is now complete! 

When you return to the menu, choose 0 to exit. 
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Using S6tup Scripts The following paragraphs describe an alternate method for setting up 

PartsDBE using setup scripts that are available on all systems. 

HP-UX Systems 

Use the following command to set up PartsDBE: 

$ /usr/lib/allbase/hpsql/setup 2 f Retum ] 

You will see a display of messages showing the progress of the 
setup script. A listing of setup appears in Appendix C of the 
ALLBASE/SQL Reference Manual. 

MPE XL Systems 

Use the command hie CREASQL to stream a job that sets up 
PartsDBE. Eirst, copy the CREASQL stream hie to your group and 
account with the following command: 

: FCOPY FROM=CREASQL.SAMPLEDB.SYS;TO=CREASQL;IEW fRihlhl'l 

Using an editor, modify CREASQL to include your password(s), 
user name, account name, and group name. Lines that need to be 
modihed are shown in inverse display. Keep the edited hie, then type 
the following command to create and load PartsDBE and copy the 
sample programs into your group and account: 

: STREAM CREASQL (Rihihi'l 

You will see messages showing the progress of the setup script. A 
listing of CREASQL appears in Appendix C of the ALLBASE/SQL 
Reference Manual. 

Looking at the Files 
Created for PartsDBE hp-ux Systems 

Use the Is -I command to list the hies in the current directory. You 
should see the following (owner and group entries will be for your 
system, and permissions will be those of your directories): 

drwxrwxr-x 3 peter dbusers 1024 Dec 27 11:23 hpsql/ 

The setup script created this directory for you. Next change into the 
hpsql directory, and do another listing: 

-rw-rw-rw- 1 peter dbusers 19297 Dec 27 11:25 isqlout 

drwxrwxrwx 2 peter dbusers 1024 Dec 27 11:24 sampledb/ 

The setup script also created the sampledb directory. The hie isqlout 
contains the messages generated when PartsDBE was created. Use 
the more command to examine isqlout. 

Einally, change into the sampledb directory, then examine the hie 
listing. You see some hies with your user name as owner and others 
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with hpdb as owner. To see the database hies alone, issue the 
following command: 

$ Is -1 I grep hpdb [Return") 

You should see the following list of hies: 


rw 

1 

hpdb 

dbusers 

204800 

Dec 

27 

11:25 

OrderDFl 

rw 

1 

hpdb 

dbusers 

204800 

Dec 

27 

11:25 

OrderXFl 

rw 

1 

hpdb 

dbusers 

512 

Dec 

27 

11:25 

PartsDBE 

rw 

1 

hpdb 

dbusers 

614400 

Dec 

27 

11:25 

PartsFO 

rw 

1 

hpdb 

dbusers 

131072 

Dec 

27 

11:25 

PartsLGl 

rw 

1 

hpdb 

dbusers 

131072 

Dec 

27 

11:25 

PartsLG2 

rw 

1 

hpdb 

dbusers 

204800 

Dec 

27 

11:25 

PurchDFl 

rw 

1 

hpdb 

dbusers 

204800 

Dec 

27 

11:25 

PurchXFl 

rw 

1 

hpdb 

dbusers 

204800 

Dec 

27 

11:25 

RecDFl 

rw 

1 

hpdb 

dbusers 

204800 

Dec 

27 

11:25 

WarehDFl 

rw 

1 

hpdb 

dbusers 

204800 

Dec 

27 

11:25 

WarehXFl 


These hies, all owned by hpdb, are the hies for the PartsDBE 
DBEnvironment. The other hies in the directory are command hies 
and load hies containing data that was loaded into PartsDBE. 

Eor security reasons, database hies are owned by hpdb, and the 
sampledb directory also belongs to hpdb. This means that you 
cannot remove the database hies with the rm command unless you 
are the superuser. (You can use SQLUtil, however, as shown later in 
this chapter.) 

The programs directory is for use when you decide to copy, 
preprocess and compile sample application programs. 
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MPE XL Systems 


ORDERDFl 

ORDERXFl 

PARTSDBE 

PARTSFO 

PARTSLGl 

PARTSLG2 

PURCHDFl 

PURCHXFl 

RECDFl 

WAREHDFl 

WAREHXFl 


List the files in the current group and account. You should see the 
following: 


PRIV 

2048W 

FB 

50 

50 

1 

800 

1 

26 

PRIV 

2048W 

FB 

50 

50 

1 

800 

1 

26 

PRIV 

256W 

FB 

1161 

1161 

1 

1920 

30 

* 

PRIV 

2048W 

FB 

150 

150 

1 

2400 

1 

31 

PRIV 

256W 

FB 

256 

256 

1 

512 

1 

29 

PRIV 

256W 

FB 

256 

256 

1 

512 

1 

29 

PRIV 

2048W 

FB 

50 

50 

1 

800 

1 

26 

PRIV 

2048W 

FB 

50 

50 

1 

800 

1 

26 

PRIV 

2048W 

FB 

50 

50 

1 

800 

1 

26 

PRIV 

2048W 

FB 

50 

50 

1 

800 

1 

26 

PRIV 

2048W 

FB 

50 

50 

1 

800 

1 

26 


These are all PRIV files, which means that you cannot purge them 
without special system authority. (However, you can use SQLUtil, as 
shown later in this chapter.) 

Additional files used for loading the sample database tables are found 
in SAMPLEDB.SYS. 
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Examining PartsDBE 


In this section, you will examine the objects that were created 
within PartsDBE—tables, views, indexes, and authority structure. 
Information about all these objects is in the system catalog, which is 
automatically created by ALLBASE/SQL as the DBEnvironment is 
conhgured. 

Run ISQL, then CONNECT to PartsDBE. (If you are using HP-UX, 
hrst change back to the directory from which you ran the script to 
create PartsDBE. You must have write permission in the directory 
from which you CONNECT.) Use one of the following CONNECT 
commands: 

Tor HP-UX: 

isql=> CONNECT TO ’hpsql/sampledb/PartsDBE’; f Retum ] 

MPE XL: 

isql=> CONNECT TO ’PartsDBE’; (Rihjhjl 

Now examine the system catalog by creating queries on the system 
views. 
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Examining th© Tabl6S Use the following query exactly as shown to look at all the tables and 
and Vi6WS views created by the setup script: 

isql=> SELECT MME, OWIER, (Rihlhll 

> DBEFILESET, TYPE fRihlhr) 

> FROM SYSTEM.TABLE (Rihlhll 

> WHERE OWIER <> ’SYSTEM’ ; (Rihlhll 

The result table is shown below. 


select name, owner, dbefileset, type from system.table where owner ’SYST 


MME 


1 OWNER 

1DBEFILESET 

ITYPE 

SUPPLYBATCHES 


1MANUFDB 

1WAREHFS 

1 

0 

TESTDATA 


1MANUFDB 

1WAREHFS 

1 

0 

PARTS 


1PURCHDB 

1WAREHFS 

1 

0 

IIVEITORY 


1PURCHDB 

1WAREHFS 

1 

0 

SUPPLYPRICE 


1PURCHDB 

IPURCHFS 

1 

0 

VEIDORS 


1PURCHDB 

IPURCHFS 

1 

0 

ORDERS 


1PURCHDB 

1ORDERFS 

1 

0 

ORDERITEMS 


1PURCHDB 

1ORDERFS 

1 

0 

PARTIIFO 


1PURCHDB 

1 SYSTEM 

1 

1 

VEIDORSTATISTICS 


1PURCHDB 

1 SYSTEM 

1 

1 

MEMBERS 


IRECDB 

IRECFS 

1 

0 

CLUBS 


IRECDB 

IRECFS 

1 

0 

EVEITS 


IRECDB 

IRECFS 

1 

0 

Number of rows se] 
U[p] , d[own] , l[ei 

ected is 13 

t] , r[ight] , t[op] , 

k_ 

b[ottom], pr[int] 

<n>, or 

e [nd] 


Figure 4-2. Information on Tables and Views 

Each table is identihed by the NAME column. The OWNER column 
specihes the database to which the table belongs. If a table does not 
belong to you (that is, if you are not the database owner), you must 
prehx the table name with its owner name whenever you refer to it. 

The DBEEILESET column contains the name of the DBEEileSet 
an entry has been associated with, and the TYPE column indicates 
whether the entry is a table or a view. Entries with type 0 are 
tables, and entries with type 1 are views. Note that all views are 
automatically associated with the SYSTEM DBEEileSet. 
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Vi6W Dsfinitions You can see the view definitions by issuing the following query 

exactly as shown: 

isql=> SELECT VIEWMME, SELECTSTRIIG fRihihri 

> FROM SYSTEM.VIEWDEF WHERE fRihihl'l 

> OWNER = ’ PURCHDB ’ ; fRihihl'l 

The query result is shown in the next figure. 


select viewnaine,s^lectstring from system.viewdef where owner = ’PURCHDB’ 

+- 

VIEWMME I I SELECTSTRING 


PARTINFO 

PARTINFO 

PARTINFO 

PARTINFO 

PARTINFO 

PARTINFO 

PARTINFO 

VENDORSTATISTICS 

VENDORSTATISTICS 

VENDORSTATISTICS 

VENDORSTATISTICS 

VENDORSTATISTICS 


I SELECT PurchDB.SupplyPrice.PartNumber, PurchDB.Parts. 

IPurchDB.SupplyPrice.VendorNumber, PurchDB.Vendors.Vend 
IPurchDB.Supplyprice.VendPartNumber, 

IPurchDB.SupplyPrice.UnitPrice, PurchDB.SupplyPrice.Dis 
I FROM PurchDB.Parts, PurchDB.SupplyPrice, PurchDB.Vendo 
IPurchDB.SupplyPrice.PartNumber = PurchDB.Parts.PartNum 
IPurchDB.SupplyPrice.VendorNumber = PurchDB.Vendors.Ven 
I SELECT PurchDB.Vendors.VendorNumber, PurchDB.Vendors. 
I, OrderDate, OrderQty, OrderQty * PurchasePrice FROM 
IPurchDB.Vendors, PurchDB.Orders, PurchDB.Orderltems WH 
IPurchDB.Vendors.VendorNumber = PurchDB.Orders.VendorNu 
IPurchDB.Orders.OrderNumber = PurchDB.Orderltems.OrderN 


Number of rows sell 
U[p] , d[own] , l[e 


ected is 12 

^t], r[ight], t [op] , b[ottom], pr[int] <n>, or e[nd] > e 


Figure 4-3. View Definitions in the System Cataiog 

Scroll to the right to examine the complete select string for each view 
definition. 
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Using the INFO You can see individual table descriptions by using the INFO 

Coninriand command, which returns the column dehnition of a table. Use the 
following command for the Vendors table: 

isql=> IIFO PURCHDB.VEIDORS; fRihihri 

The output from this ISQL command is shown below: 


isql=> info purchdl 

Column Name 

.vendors; 

Data Typ 

e (length) 

Nulls Allowed 

Language 


VENDORNUMBER 

Integer 


NO 



VENDORNAME 

Char ( 

30) 

NO 

n-computer 


CONTACTNAME 

Char ( 

30) 

YES 

n-computer 


PHONENUMBER 

Char ( 

15) 

YES 

n-computer 


VENDORSTREET 

Char ( 

30) 

NO 

n-computer 


VENDORCITY 

Char ( 

20) 

NO 

n-computer 


VENDORSTATE 

Char ( 

2) 

NO 

n-computer 


VENDORZIPCODE 

Char ( 

10) 

NO 

n-computer 


VENDORREMARKS 

VarChar 

( 60) 

YES 

n-computer 



_ 




_J 


Figure 4-4. Output of the INFO Command 

The Column Name column lists the names of all the columns in 
the table. The Data Type column shows the specihc data type for 
each column and its size (in parentheses). The third column, Nulls 
Allowed, indicates whether or not NULL values are permitted in 
the column, and the Language column indicates which language is 
applicable for the column if it is a character type. 
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ExamininQ Indaxas The following query shows the indexes on tables in PartsDBE: 

isql=> SELECT IIDEXMME, TABLEMME, fRihlhr) 

> UIIQUE, CLUSTER FROM SYSTEM. IIDEX; fRihlhr) 

The query result is shown in the next hgure: 



The UNIQUE and CLUSTER columns show what kind of index was 
created: PartNumIndex is a unique index; PartToNumIndex is a 
clustering index; OrderNumIndex is both unique and clustering; and 
OrderVendindex is neither unique nor clustering. 
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ExamininQ th© Authority An authority structure consists of many elements. Some of these 
StruCtur© elements are shown below: 

■ Group dehnitions. 

■ Table authorizations for select, insert, update, and delete 
operations on tables. 

■ Column authorizations for permission to update specihc columns. 

Groups 

Use the following query to examine the authorization groups in 
PartsDBE and their members: 

isql=> SELECT * FROM SYSTEM. GROUP; fRihihl'l 

The query result is shown below: 


select * from systjem.group; 

-+- 


USERID 

1GROUPID 

1OWIER 

1IMEMBERS 


PURCHMAIAGERS 

1PURCHMAIAGERS 

1 PETER 

1 

3 

MARGY 

1PURCHMAIAGERS 

1 PETER 

1 

0 

ROM 

1PURCHMAIAGERS 

1 PETER 

1 

0 

SHAROI 

1PURCHMAIAGERS 

1 PETER 

1 

0 

PURCHDBMAIIT 

1PURCHDBMAIIT 

1 PETER 

1 

3 

AIIIE 

1PURCHDBMAIIT 

1 PETER 

1 

0 

DOUG 

1PURCHDBMAIIT 

1 PETER 

1 

0 

DAVID 

1PURCHDBMAIIT 

1 PETER 

1 

0 

PURCHASIIG 

1PURCHASIIG 

1 PETER 

1 

5 

AJ 

1PURCHASIIG 

1 PETER 

1 

0 

JORGE 

1PURCHASIIG 

1 PETER 

1 

0 

RAGAA 

1PURCHASIIG 

1 PETER 

1 

0 

GREG 

1PURCHASIIG 

1 PETER 

1 

0 

KAREI 

1PURCHASIIG 

1 PETER 

1 

0 

RECEIVIIG 

1RECEIVIIG 

1 PETER 

1 

3 

AL 

1RECEIVIIG 

1 PETER 

1 

0 


First 16 rows havd 
U[p] , d[own] , l[e 


been selected. 

4t], r[ight], t[op], b[ottom], pr[int] <n>, or e[nd] > e 


Figure 4-6. Groups in the System Cataiog 


For each group, the members are listed. Note that the group and the 
member names are listed in the USERID column, and the number of 
members appears in each row where the group name appears as a 
USERID. The OWNER column shows the owner of the authorization 
group. 
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Table Authorities 


Use the following query exactly as shown to examine the 
authorizations on the PurchDB.Inventory table: 

isql=> SELECT USERID, SELECT, IISERT, fRihihr) 

> UPDATE, DELETE, ALTER, INDEX [Return"] 

> FROM SYSTEM.TABAUTH WHERE (Rihihil 

> MAME = ’ IMVEMTORY’ ; (Rihihil 

The query result is shown below: 




f - 






select userid. 

se] 

ect, 

insert, 

update 

,delete. 

alter. 

index from system.taba 

USERID 


1 SELECT 1 INSERT|UPDATE|DELETE|ALTER|INDEX 

PURCHMAIAGERS 


lY 

IN 

IN 

IN 

IN 

IN 

PURCHDBMAIIT 


lY 

lY 

lY 

lY 

lY 

lY 

PURCHASING 


lY 

lY 

lY 

lY 

IN 

IN 

WAREHOUSE 


lY 

lY 

lY 

lY 

IN 

IN 

KELLY 


IN 

IN 

IC 

IN 

IN 

IN 

PETER 


IN 

IN 

IC 

IN 

IN 

IN 

DBEUSERS 


lY 

lY 

lY 

lY 

IN 

IN 

Number of rows 

se] 

ected 

is 7 





c 

1—1 

1_1 

1—1 
o 

p 

1_1 

I[ei 

t] , r 

Eight] , 

t[op] , 

b[ottom] 

, pr[int] <n>, or e[nd] > e 



_ 





_ J 


Figure 4-7. Table Authorities in the System Catalog 

Each row contains a USERID, which is the name of a user or group, 
and an entry for each type of authority. A Y in a column indicates 
that the USERID has that authority, an N indicates the USERID 
does not have that authority. 


Column Authorizations A special kind of authorization is the permission to update 

specihc columns in a table. These permissions are shown in the 
SYSTEM.COLAUTH view in the system catalog. 

Use the following query exactly as shown to display the column 
authorizations dehned for the PurchDB.Inventory table: 

isql=> SELECT USERID, TABLEIAME, fRihihi'l 

> OWNER, COLMAME FROM (Rihihi'l 

> SYSTEM.COLAUTH WHERE (Rihihi'l 

> TABLEIAME = ’ IIVEITORY ’ ; fRihihri 

The query result is shown in the next hgure: 
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select userid, taalename, owner, colname from system.colauth where tablenam 


USERID 

-+- 

1TABLENAME 

-+- 

1 OWNER 

-+- 

1COLNAME 

KELLY 

1 INVENTORY 

1PURCHDB 

IBINNUMBER 

KELLY 

1 INVENTORY 

1PURCHDB 

1QTYONHAND 

KELLY 

1 INVENTORY 

1PURCHDB 

ILASTCOUNTDAT 

PETER 

1 INVENTORY 

1PURCHDB 

IBINNUMBER 

PETER 

1 INVENTORY 

1PURCHDB 

1QTYONHAND 

PETER 

1 INVENTORY 

1PURCHDB 

ILASTCOUNTDAT 


Number of rows selected is 6 

U[p] , d[own] , l[eit], r[ight] , t [op] , b[ottom], pr[int] <n>, or e[nd] > e 


Figure 4-8. Column Authorities in the System Catalog 
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Using the 
Preprocessors 


Sample Application 
Programs 


For large-scale database access or for batch operation, 
ALLBASE/SQL includes a set of preprocessors, which let you embed 
SQL commands into the source code for your own applications. 

Before compiling your program, you use the preprocessor to prepare 
the program for runtime database accesses. Separate preprocessors 
are available for C, COBOL, FORTRAN, and Pascal. 

In addition to the hies for creating PartsDBE, your system includes 
a set of sample application programs that use embedded SQL. 

You can use option 3 from the SQLSetup menu to preprocess and 
compile all of the examples for a given programming language, 
or you can examine a single program at a time as shown in the 
next section. The sample application programs for MPE XL are 
located in SAMPLEDB.SYS, and in HP-UX, they are found in 
/usr/lib/allbase/hpsql/programs. 

Using the sample DBEnvironment PartsDBE installed on your 
system as described earlier in this chapter, you can step through 
the process with the following commands. This example uses the C 
preprocessor; follow the steps shown here for your operating system. 
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For HP-UX: First, change into the hpsql directory created when you set up the 

sample DBEnvironment PartsDBE, as shown in an earlier step. Then 
change into the programs directory if it exists. If it does not exist, 
create it, then change into it as follows: 

mkdir programs 
cd programs 

Issue the following commands, one at a time (some will take a few 
moments to execute): 

$ rm cex2. sql [ Return ") Only needed if this file exists already. 

$ cp /usr/lib/allbase/hpsql/programs/cex2 cex2.sql f Retum] 

$ psqlc . ./sampledb/PartsDBE -i cex2.sql -d fRetum") 


Series 800: 

$ cc cex2.c -o cex2.r -Isql -Icl -Iportnls [Return ") 

Series 300: 

$ cc cex2.c -o cex2.r -Isql -lheap2 -Iportnls -Ipc [Return) 


$ more Cex2 . sql [Return ") 

$ more cex2 . C [Return") 

This sequence copies the source hie from the sample database 
directory to the local directory, then preprocesses and compiles 
the program. The more commands let you examine the differences 
between the embedded SQL source hie and the preprocessor output 
hie. 

Use the following command to execute the program: 

$ ./cex2.r [Return ") 

When prompted for part numbers, enter the following, and observe 
the results: 

1123-P-Ol 

1323-D-Ol 

9999-X-Ol 
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For MPE XL: First, make sure you are in the group and account where PartsDBE 

exists. Then issue the following commands, one at a time (some take 
a few moments to execute): 

: PURGE CEX2 f Return ] Only needed if this file exists already. 

: FCOPY FR0M=CEX2.SAMPLEDB.SYS;T0=CEX2;IEW fRihihl'l 
: PPG CEX2,PARTSDBE,CEX2P [Return"] 

: SAVE SQLOUT (Rihihll 
: PRUT CEX2 fRihihr) 

: PRUT SQLOUT fRihihr) 

This sequence copies the source hie from the sample database group 
and account to your local group, then preprocesses and compiles the 
program. The SAVE command keeps a copy of the preprocessor 
output hie SQLOUT in your local group. The PRINT commands let 
you examine the differences between the embedded SQL source hie 
and the preprocessor output hie. 

Use the following command to execute the program: 

: CEX2P (Rihihll 

When prompted for part numbers, enter the following, and observe 
the results: 

1123-P-Ol 

1323-D-Ol 

9999-X-Ol 


Examining Startup 
Parameters with 
SQLUtil 


Use the SQLUtil program to examine the startup parameters of 
PartsDBE or any other DBEnvironment. Run the program as follows 
(if you are using HP-UX, hrst make sure you are in the same working 
directory from which you created PartsDBE): 

sqlutil [ Return") 

SQLUtil displays a banner like the following (some details can be 
different on your system): 


HP36217-02A 
(C)COPYRIGHT 
1989. ALL R] 

>> 


WED, AUG 08, 1990, 11:30 AM 
07.00.17 DBE Utility/9000 HP SQL/HP-UX 

HEWLETT-PACKARD CO. 1982,1983,1984,1985,1986,1987,1988, 
GHTS RESERVED. 


Figure 4-9. SQLUtil Banner 
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Respond to the prompts as in the following dialog. For DBEName, 
enter hpsql/sampledb/PartsDBE in HP-UX, or PartsDBE in MPE 
XL. 


>> SHOWDBE [Return^ 

DBEnvironment Name: DBEName 
Maintenance Word: f Retum] 

Output File Name (opt) : f Return ~) 
ALL f Return^ 
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The following display should appear (some details can vary on your 
system): 

Maintenance word: 

DBEnvironment Language: n-computer 

AutoStart: ON 

User Mode: MULTI 

DBEFileO Name: PartsFO 

DDL Enabled: YES 

No. of Runtime Control Block Pages: 37 
No. of Data Buffer Pages: 100 
No. of Log Buffer Pages: 24 
Max. Transactions: 5 


>> E f Return ~) 

Use the E command to exit from SQLUtil and return to your 
operating system. 

The parameters shown above describe the conhguration of the sample 
DBEnvironment immediately after setting it up with SQLSetup. All 
of them are described in the “DBEnvironment Conhguration and 
Security” chapter of the ALLBASE/SQL Database Administration 
Guide, so they are not described further here. Many of them can 
be adjusted by the database administrator to meet the needs of a 
particular system. 
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Creating 
File with 


a Schema 
SQLGEN 


Use option 4 from the SQLSetup menu to create a file that shows all 
the data dehnition commands that were used to build PartsDBE. As 
an alternative, run the SQLGEN program, as follows: 


sqlgen fRetum ] 


SQLGEN displays its banner (some details can be different on your 



system): 



r 


HP36217- 
(C) COP^ 

WED, AUG 08, 1990, 

02A.07.00.04 SQL Command Generator 

RIGHT HEWLETT-PACKARD CO. 1986,1987,1988,1989 

11:30 AM 

HP SQL/UX 

>> 

< _ 

_ ; 


Figure 4-10. SQLGEN Banner 

Respond to the prompts as in the following dialog. Eor DBEName, 
enter hpsql/sampledb/PartsDBE in HP-UX, or PartsDBE in MPE 
XL. 

>> Startdbe fReturn~) 

DBEnvironment Name >> DBEName fRetum ] 


DBEnvironment successfully started. 
>> gen all fRetum ] 


HP SQL Command Generator for ALL 

Schema File Name or ’//’ to STOP command >> PartsSch f Retum ] 

Messages are displayed for each of the commands SQLGEN is 
inserting into the hie PartsSch. Below are some of the messages: 

Generating command to START DBE PartsDBE 
Generating command to CREATE DBEFILESET ORDERFS 
Generating command(s) for DBEFILE ORDERDATAFl 
Generating command(s) for DBEFILE ORDERINDXFl 
Generating CREATE TABLE PURCHDB.INVENTORY 
Generating CREATE TABLE PURCHDB.ORDERITEMS 


If you created the schema hie with SQLSetup, use option 5 to view 
the hie. Otherwise, use an operating system command to examine hie 
PartsSch. 
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Purging PartsDBE 


Use SQLUtil to purge PartsDBE when you no longer need it. Within 
SQLUtil, you use the PURGEALL command: 

>> purgeall fRetum ] 

DBEnvironment Name: PartsDBE f Retum] 

Purge DBEnvironment and Log Files (y/n)? y f Return ~) 

DBEnvironment and Log Files purged. 

>> exit f Retum^ 

You can also use SQLSetup option 6 to purge PartsDBE. 
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If you are coming to ALLBASE/SQL from the world of 
TurbolMAGE, this chapter should help you make the necessary 
translations from the terminology of a network DBMS to the 
terminology of a relational DBMS. 
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The following topics are covered: 

■ Basic structures. 

■ Procedures for starting up. 

■ Tables and indexes versus data sets. 

■ Mapping of data types. 

■ Differences in security. 

■ Differences in accessing databases. 

■ Sample mapping of a TurbolMAGE database to an 
ALLBASE/SQL DBEnvironment. 

■ Using ALLBASE/Turbo CONNECT. 

The goal in discussing these topics is not to present a complete 
picture of either system, but rather to suggest some points of 
correspondence in order to make learning ALLBASE/SQL easier. 

The discussion is deliberately oversimplihed. Eor dehnitions of 
ALLBASE/SQL terms, refer to chapter I, “Very Basic ... ,” and 
to chapter 6, “Glossary of Terms in ALLBASE/SQL.” Complete 
information about TurbolMAGE is in the TurboIMAGE/XL 
Database Management System Reference Manual. 
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Basic Structures 


Figure 5-1 shows the basic architecture of the TurboIMAGE system. 



The TurboIMAGE database manager accesses data in each data set 
as needed, based on information given in the root hie. 
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Figure 5-2 shows the ALLBASE/SQL architecture. 


Procedures for 
Starting Up 
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Figure 5-2. ALLBASE/SQL Architecture 


ALLBASE/SQL has two components which manage access to 
databases, SQLCore and DBCore. The data is stored in tables which 
reside physically in DBEFiles and logically in DBEFileSets, as shown 
in Figure 5-2. These elements are described further in the next 
paragraphs. 


In TurboIMAGE, you start up a database with the following steps: 

1. Create a schema. A common way of doing this is to enter the 
schema into a text hie created with an editor. 

2. Run DBSCHEMA to generate a root hie from the schema. 

3. Run DBUtil to create data sets based on the root hie. 

The schema contains dehnitions of all the data items in your 
database, and it describes all the data sets in the database. It also 
specihes the required security for the database by dehning passwords 
for specihc users. 

In ALLBASE/SQL, you start up a DBEnvironment with a simple 
SQL command. The command may be issued interactively (through 
ISQL), or through an application program. The START DBE NEW 
command is as follows: 

START DBE ’ DBEnvironmentName’ lEW 

The START DBE NEW command creates a hie known as a 
DBECon hie, which is similar to the root hie in TurboIMAGE. 
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Use of a Schema 


Root File versus 
DBECon File and 
System Catalog 


Data Files for Data sets 
versus DBEFiles for 
Tables 


The DBECon file contains information about startup parameters 
for the DBEnvironment and its logs. START DBE NEW also 
creates a structure within the DBEnvironment known as a system 
catalog, which is a set of information about all the databases in the 
DBEnvironment. 

In TurboIMAGE, a schema is required to define a database. Most 
users create the schema in an ASCII file. Once the database exists, 
the schema can serve as a record of its contents. The schema can also 
be used to create the same database structure in dilferent groups and 
accounts or on dilferent systems. 

You can also create a schema for ALLBASE/SQL by entering 
into an ASCII file all the SQL commands needed to configure the 
DBEnvironment and create all the objects in it. You can use this 
file as input to ISQL. However, in ALLBASE/SQL, no schema is 
required; all that is necessary to configure a DBEnvironment is a 
START DBE NEW command issued through ISQL or an application 
program. 

In TurboIMAGE, the root file, which is generated by DBSCHEMA 
from the schema, contains security information and definitions of all 
the data sets in the database, together with the name of the database 
creator. 

The DBECon file in ALLBASE/SQL is created when you issue the 
START DBE NEW command. The DBECon file, which has the same 
name as the DBEnvironment, contains the name of the DBECreator 
and the names of the logs associated with the DBEnvironment. It 
also indicates startup parameters, such as SINGLE or MULTI user 
mode, and others (examples are shown in the section “Examining 
Startup Parameters with SQLUtil” in chapter 4). 

In ALLBASE/SQL, structural information is also stored internally 
in a set of system tables known as the system catalog. This is like 
an internal schema. The DBECon file does not contain the names 
of tables or other database objects; these are stored in the system 
catalog. 

Each data set in a TurboIMAGE database occupies a separate MPE 
XL file, created by TurboIMAGE as a PRIV file. The file size is 
determined from the capacity you indicate for the data set in the 
schema. 

In ALLBASE/SQL, you create a table inside a DBEEileSet, to which 
you have added one or more DBEEiles. These DBEEiles need to 
be large enough for the amount of data you need to store. Instead 
of specifying a capacity, you create DBEEiles of whatever size is 
needed. DBEEiles can hold data and/or indexes for more than one 
table at a time; no simple correspondence between tables and data 
files exists. You do not specify the size of a table when you create 
it; the table size is limited only by the capacity of your system. As 
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Naming Conventions 


Tables and Indexes 
versus Data Sets 


Automatic Masters 
versus Indexes 


you need additional space for a growing table, you add DBEFiles to 
the DBEFileSet in which the table was created. This increases the 
capacity of the table. (An exception to this is tables created as hash 
structures, described in a later section.) 


The names of data items and data sets within a TurboIMAGE 
schema may contain some characters which are not allowed in 
ALLBASE/SQL. For example, the hyphen is not allowed in 
ALLBASE/SQL names; so hyphens need to be represented in some 
other way in ALLBASE/SQL, for example, by an underscore (_). 


The basic unit of storage for data items in TurboIMAGE is the data 
set, which consists of a set of records containing an ordered series of 
data items. A data set is either a detail or a master, and, if it is a 
master, it is either manual or automatic. 

In ALLBASE/SQL, the basic unit of storage is the table, which is an 
unordered set of rows containing data items. Tables are not labeled 
manual or automatic, master or detail; but the same relationships 
are possible through the creation of different types of indexes or 
index-like structures. 

Each TurboIMAGE automatic master data set has a unique key 
item, which provides calculated access to the data in the master, 
and chained access to the data in one or more detail data sets. Like 
an ALLBASE/SQL index, an automatic master is maintained by 
the system; that is, when the table or detail data set is updated, 
the index or automatic master is updated automatically. Also, 
you cannot have an index without a table, and you cannot have 
an automatic master without a detail data set. Both indexes and 
automatic masters contain only key data values. 

One difference between the automatic master and the index is 
that an automatic master may serve up to 16 detail data sets, 
whereas an index serves only one key within one table. However, 
separate indexes can be created on similar keys in other tables, 
and many indexes may exist on the same table. Another difference 
is that ALLBASE/SQL indexes use a B-tree structure, whereas 
TurboIMAGE master data sets use calculated (hash) access to key 
values. 
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Manual Masters versus 
Hash Structures 


Master/Detail versus 
Referential Integrity 


Sort Items versus 
Indexes 


Each TurboIMAGE manual master data set has a unique primary 
key item, which provides calculated access to the data in the master, 
and chained access to the data in the detail data set (if one exists). 

A manual master may contain data items other than just the key 
item; therefore, it cannot be automatically updated when detail data 
changes. 

When you create an ALLBASE/SQL table as a hash structure, 
it behaves like a manual master data set, in that it has a unique 
primary key with calculated access to the key value. Like manual 
masters, hash structures have the advantage of speed when the key 
value is known exactly, but are less efficient than normal indexes 
when a range of values is required. 

The TurboIMAGE manual master provides the following methods for 
enforcing data integrity: 

■ Insisting that key values entered into the detail data set already 
exist in the manual master. 

■ Preventing deletions of key values in the manual master without 
prior deletion of the same key values in the detail data set. 

In ALLBASE/SQL, you can achieve the same end by creating a table 
with a referential constraint and specifying the following clause: 

HASH 01 COISTRAIIT 

This causes a unique hash key in the table (that is, the referenced or 
master table) to be related to a foreign key in another table (that is, 
the referencing or detail table). 

In TurboIMAGE, you can specify sort items that become the basis 
for the sorted order of the output in queries to the database. You 
cannot use the search item as a sort item, however, because the 
search item points to a chain of entries whose order is hxed, and this 
order is not necessarily the same as the sort order. 

In ALLBASE/SQL, you can use the ORDER BY clause in the 
SELECT command to sort by any column you wish. ALLBASE/SQL 
tables are essentially unordered sets of rows, so they can be accessed 
in any order. Sorting is improved markedly, however, by the use of 
an index on the sort key. Note that the sort key can be and often is 
the same as the primary key in the table. 
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Mapping of Data 
Types 
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Both TurboIMAGE and ALLBASE/SQL have data types that do 
not map exactly to a type in the other system. But a satisfactory 
mapping with appropriate conversions can easily be done for most 
TurboIMAGE data types. 

Basic Mapping Table 5-l shows the mapping of the most common data types from 
TurboIMAGE to ALLBASE/SQL: 


Table 5-1. Mapping of TurboIMAGE and ALLBASE/SQL Data Types 


TurboIMAGE 
Data Type 

ALLBASE/SQL 
Data Type 

Description 

LJ 

SMALLINT 

16-bit integer 

12,J2 

INTEGER 

32-bit integer 

K1,K2 

INTEGER 

Requires conversion from binary to integer 

P n 

DEGIMAL( M-1,0) 

Packed decimal 

R4 

ELOAT 

Gonversion from HP 3000 real to IEEE real 

U( n), X( n) 

GHAR( n) 

Byte character string 

Z n 

DEGIMAL( M,0) 

Requires conversion from zoned decimal to packed decimal 


Compound Itoms TurboIMAGE compound items are not compatible with 

ALLBASE/SQL data types, because ALLBASE/SQL does not 
accomodate arrays. In ALLBASE/SQL, you need to create a 
separate column description for each member of the compound. 

Null Handling TurboIMAGE does not support null values. Thus, a null value is 

often represented as an empty string or as zero (for numeric values). 

In ALLBASE/SQL, a special data type NULL can be used to 
indicate the absence of a value; NULL is distinct from 0 or from an 
empty string, which are like any other values. If columns are not 
permitted to contain nulls in ALLBASE/SQL, you must dehne the 
column as NOT NULL when you create the table. 
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Differences in 
Security 

TurbolMAGE Security 


Granting and Revoking 
Authorities 


Defining ALLBASE/SQL 
Groups 


Defining Views in 
ALLBASE/SQL 


TurbolMAGE and ALLBASE/SQL differ markedly in their 
implementation of security systems. 


The security of TurbolMAGE databases is determined partly by 
passing MPE hie system security and partly by the assignment of 
user classes and passwords within the schema. Externally, database 
users must be valid users in the account where the root hie resides. 
Eor internal security, you dehne a numbered set of classes and assign 
passwords to them, then you add the classes that have read and/or 
write access to each data item and data set description in the 
schema. When accessing the database, you must specify a password, 
which assigns you to a user class with particular permissions in the 
database. 

In ALLBASE/SQL, the DBA (database administrator) GRANTs 
and REVOKES authorities that relate to the DBEnvironment as a 
whole or to specihc tables within it. If you are the DBEnvironment’s 
creator, you have DBA authority. Users can CONNECT to a 
DBEnvironment if the DBA grants CONNECT authority to their 
DBEUserlDs, which are related to login name. It is possible to 
CONNECT to a DBEnvironment from any account. 

If you are the creator of a table, you have OWNER authority over 
it, which lets you perform any operation on it, including granting 
authorities to other users. Table authorities include the ability to 
SELECT, DELETE, INSERT, and INDEX. UPDATE authority can 
be granted for individual columns in a table or for the table as a 
whole. 

In ALLBASE/SQL, you can dehne authorization groups and then 
grant authorities to them; then you can add users to the groups, 
at which point they immediately receive the authorities the group 
possesses. This makes it possible to create an authorization scheme 
that is independent of any list of particular users and passwords. 

An authorization group may be a member of another authorization 
group. 

A different approach to security is possible in ALLBASE/SQL 
through the use of views. Eor a table that contains some sensitive 
information and some widely used information, you can create a view 
that contains only the widely-used information, grant appropriate 
access on the view to a wide range of users, then restrict the access 
on the base table to only a few users. 
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Differences in 

Accessing 

Databases 

Interactive Access 


Programmatic Access 


4GL 


Differences in 
Concurrency Control 
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TurboIMAGE and ALLBASE/SQL both offer a variety of tools for 
accessing databases, and both provide techniques for concurrency 
control, to regulate access by more than one user at a time. 


TurboIMAGE interactive access is through Query/V, which lets you 
hud database entries and report on them using the Query command 
language. In ALLBASE/SQL, the interactive interface is known as 
ISQL, which uses Structured Query Language (SQL) to access the 
database and display query results. 

Eor sophisticated reporting. Business Report Writer supports both 
TurboIMAGE and ALLBASE/SQL databases. 


A major difference between TurboIMAGE and ALLBASE/SQL is in 
the programmatic interface. TurboIMAGE uses a set of intrinsics 
which you use in application programs to open databases, obtain 
locks, retrieve data, unlock data items and data sets, and close a 
database. 

ALLBASE/SQL uses embedded SQL programming. You insert 
standard SQL statements in an application program, then you 
preprocess the program to convert the SQL statements into valid 
procedure calls in the language you are using. The converted code is 
compiled and linked with a library of ALLBASE/SQL routines. The 
use of embedded SQL means that you can prototype and test your 
queries in ISQL before running them in an application, thus saving 
development time. Embedded SQL also includes a set of dynamic 
commands which let your end users perform ad hoc queries through 
your applications. 

You can use ALLBASE/4GL as a programming tool to create 
applications that can access both TurboIMAGE and ALLBASE/SQL 
databases—even at the same time. Simply dehne the appropriate 
data sets and/or tables in ALLBASE/4GL’s dictionary, then create 
screens and menus. As a fourth-generation tool, ALLBASE/4GL lets 
you avoid tedious and repetitive coding. 

Concurrency control is needed to protect the consistency of a 
database when it is in multiuser operation. TurboIMAGE permits 
concurrent access through a mechanism known as access mode. You 
choose one of the eight modes of access as you open the database. 
These modes offer a wide range from very restrictive single user 
exclusive access to multiuser access with updates permitted by 
different users. Some access modes enforce the application’s locking 
of data sets; others do not. 

ALLBASE/SQL uses two DBEnvironment access modes: SINGLE 
and MULTI user mode, which you set when you create the 
DBEnvironment. (You can also change modes using SQLUtil.) In 
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Locking Mechanisms 


addition, tables have an access mode, which you specify when you 
create them. Tables may be PUBLIC, PUBLICREAD, or PRIVATE, 
as follows: 

PUBLIC may be read or updated by anyone who has 

authority to CONNECT to the DBEnvironment. 

PUBLICREAD may be read by anyone but only updated by one 
user at a time. 

PRIVATE may only be read or updated by a single user at a 

time. 

In TurboIMAGE, you use the DBLOCK intrinsic in certain access 
modes to provide locking at the database level, the data set level, 
or the data item level. Locking must be explicitly requested by the 
user; it is required for concurrent updates. You can request locks 
conditionally in TurboIMAGE, which means that the call returns if 
the lock request fails. 

ALLBASE/SQL provides automatic locking for all data manipulation 
commands—reads and writes. Locking is unconditional, and it 
applies at the level of the table or the data page; row level locking 
is not supported. You can also use the explicit LOCK TABLE 
command. Eurther, you can specify an isolation level, which 
determines the kinds of locks obtained by ALLBASE/SQL. Isolation 
level applies to transactions, which are bounded by the SQL BEGIN 
WORK and COMMIT WORK commands. Tour isolation levels are 
possible: 

RR Repeatable Read. The strongest locks are used to assure 

continuity of data from one read to another within the same 
transaction. 

CS Cursor Stability. Weaker locks are obtained and released as 
needed during the scan of a particular database table. 

RC Read Committed. Weaker locks are obtained but released 
even sooner during the scan of a particular database table. 
RU Read Uncommitted. No locks are obtained. 

Eor complete information about these isolation levels, refer to the 
chapter “Concurrency Control Through Locks and Isolation Levels” 
in the ALLBASE/SQL Reference Manual. 

Concurrency control is complex, and no exact mapping between the 
two systems is possible. 
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Sample Mapping of 
a TurbolMAGE 
Database to an 
ALLBASE/SQL 
DBEnvironment 


ITEMS: 


BIIIUMBER 

, K 

(12,14/18) 

COUITCYCLE 

1—1 
CO 

(12/18); 

ITEMCOUIT 

CN 
1—1 

(/14,18); 

LASTCOUITDATE 

00 

X 

(12/18); 

PARTIAME 

, X32 

(14/12,18) 

PARTIUMBER 

, X16 

(14/12,18) 

SALESPRICE 

, P12 

(/12,18); 

WAREHOUSE 

, X32 

(/12,18); 


SETS: 

MME: PARTS, MAIUAL; 

EITRY: 

PARTIUMBER(l), 

PARTIAME, 

SALESPRICE; 

CAPACITY: 301; 

MME: IIVEITORY, DETAIL; 

EITRY: 

PARTIUMBERCPARTS), 

BIIIUMBER, 

ITEMCOUIT, 

WAREHOUSE, 

LASTCOUITDATE, 

COUITCYCLE; 

CAPACITY: 200; 

EID. 

You might implement this design using a set of SQL commands such 
as the following: 

START DBE ’TIPARTS’ lEW; 

CREATE GROUP BUYER; 

CREATE GROUP CLERK; 

CREATE GROUP DO.ALL; 

COMMIT WORK; 

CREATE DBEFILESET DATAFS; 

CREATE DBEFILE DATAFl WITH 


Consider the following TurbolMAGE schema: 

BEGII DATABASE TIPART; 

PASSWORDS: 

12 BUYER; 

14 CLERK; 

18 DO-ALL; 
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PAGES=200, MME=’DATAF1’, TYPE=MIXED; 
ADD DBEFILE DATAFl TO DBEFILESET DATAFS; 
CREATE PUBLIC TABLE IIVEITORY 


(PARTIUMBER 

CHAR(16) 

lOT lULL 

REFEREICES 

PARTS (PARTIUMBER), 

BIIIUMBER 

IITEGER 

lOT lULL, 

ITEMCOUIT 

IITEGER 

lOT lULL, 

WAREHOUSE 

CHAR(32) 

lOT lULL, 

LASTCOUITDATE CHAR(8) 

lOT lULL, 

COUITCYCLE.l 

SMALLIIT 

lOT lULL, 

C0UITCYCLE_2 

SMALLIIT 

lOT lULL, 

C0UITCYCLE_3 
II DATAFS; 
COMMIT WORK; 

SMALLIIT 

lOT lULL) 


CREATE DBEFILESET HASHES; 

CREATE DBEFILE HASHFl WITH 
PAGES=350, MME= ’HASHFl’; 

ADD DBEFILE HASHFl TO DBEFILESET HASHES; 

CREATE PUBLIC TABLE PARTS 

(PARTIUMBER CHAR(16) HOT HULL, 

PARTMME CHAR(32) HOT HULL, 

SALESPRICE DECIMAL(11,0) HOT HULL) 

HASH 01 (PARTIUMBER) PAGES=301 
II HASHES; 

COMMIT WORK; 

REVOKE ALL 01 IIVEITORY FROM PUBLIC; 

REVOKE ALL 01 PARTS FROM PUBLIC; 

GRAIT SELECT 01 IIVEITORY, PARTS TO 
BUYER, CLERK, DO.ALL; 

GRAIT IISERT, UPDATE, DELETE 01 
IIVEITORY, PARTS TO DO.ALL; 

GRAIT UPDATE 01 IIVEITORY 

(PARTIUMBER, ITEMCOUIT) TO CLERK; 

GRAIT UPDATE 01 PARTS (PARTIUMBER, PARTIAME, 

SALESPRICE, WAREHOUSE) TO BUYER; 

COMMIT WORK; 

This mapping is intended as illustrative only, not an exact migration 
of the database. To create an exact mapping, you would create views 
to dehne specihc subsets of the tables, grant authorities on the views 
to appropriate users, then revoke access to the base tables. 
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Using 

ALLBASE/Turbo 

CONNECT 


ALLBASE/Turbo CONNECT allows you to select TurboIMAGE/XL 
data using ALLBASE/SQL. Using the utility program ATCUtil, 
you attach the TurboIMAGE database to an ALLBASE/SQL 
DBEnvironment as shown in Eigure 5-3. The attachment process 
creates a mapping of data sets to tables like the one shown previously 
in this chapter. 
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Figure 5-3. Using ALLBASE/Turbo CONNECT 

After attaching, you can use ALLBASE/Turbo CONNECT for 
read-only access of TurboIMAGE data from an ALLBASE/SQL 
DBEnvironment—interactively or in application programs. 

Eor complete information about ALLBASE/Turbo CONNECT, refer 
to the ALLBASE/Turbo CONNECT Administrator’s Guide. 
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Glossary of Terms in ALLBASE/SQL 


Ad Hoc Query 


Archive Logging 


Attribute 



Type of query that is issued for the needs of a particular moment. It 
is usually not stored for later use or built into an application. Ad hoc 
queries are important in the use of relational databases for decision 
support. 

Logging method that uses log hies to roll back incomplete 
transactions after a system failure and to roll forward from an earlier 
DBEnvironment backup. Uses a relatively large hie or set of hies to 
record all activity that modihes databases from the point at which 
you do a backup of the entire DBEvironment. If the logs are intact 
following a hard crash, you can recover a DBEnvironment from an 
earlier saved version. 

A characteristic of a data element considered during database design. 
As you organize your data, you arrange it into categories that possess 
similar attributes. The categories are known as entities. 
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Authority 

Authorization Group 
Base Table 
Class 

Clustering Index 

Column 

Column Authorization 
Column List 
Concurrency 

Constraint 

Cursor Stability (CS) 


Permission to access specific objects for specific purposes within an 
ALLBASE/SQL DBEnvironment. Three major types are SPECIAL 
authority, TABLE authority, and RUN authority. 

See Group. 


Table upon which a view is based. 


Special category of ALLBASE/SQL owner that is neither a particular 
DBEUserlD nor a group. You do not explicitly create a class; you 
create it implicitly by creating objects owned by it. A class does not 
have members like a group. Objects owned by classes can be dropped 
or modified only by a DBA. A class does not have a password 
associated with it. 

An index which attempts to locate new rows in physical proximity to 
other rows with similar key values. Valuable when a large number of 
inserts follows a similar large number of delete operations. 

Vertical division within a database table. Analogous to a field in a 
file. 

Permission to update a specific column within a table. 


One or more columns specified as part of a query result. 


The ability of multiple users to access the same database files 
simultaneously. Concurrency is regulated by locking, which controls 
the degree of concurrent access permitted—from exclusive read or 
write access to shared read with concurrent updates. 

A condition placed upon a column or table that requires values in 
the column or table to meet certain conditions before a row can be 
inserted or deleted. Two types supported by ALLBASE/SQL are 
unique constraints and referential constraints. 

An isolation level that guarantees that any data on the page you 
are currently accessing cannot be updated by other users until you 
move off that page. This offers a greater degree of concurrency than 
Repeatable Read, which is the default isolation level. 
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Data Analysis 

Database 

Database Administrator 
(DBA) 

Database Design 
Data Control Language 

Data Definition 

Data Definition 
Language 

Data Manipulation 

Data Manipulation 
Language 

Data Type 
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Study of raw data before building a database. Concerns the kind of 
data that is to be stored and how the data is to be used. 

A structured arrangement of data elements designed for the easy 
selection of information. In ALLBASE/SQL, a database is a 
collection of tables, views, and indexes having the same ownership 
in a DBEnvironment. A DBEnvironment may contain several 
databases. 

The individual with DBA authority who creates and maintains 
objects in a DBEnvironment. DBA authority permits the use of 
certain restricted SQL and SQLUtil commands or options, and also 
confers co-ownership of all the objects in a DBEnvironment. 

The creation of a specihc arrangement of data in tables or data sets 
with an appropriate security structure. 

The set of SQL commands that control access to data. This includes 
the ADD, REMOVE, GRANT, and REVOKE commands, as well as 
the commands to create, manage, and drop authorization groups. 
Also known as DCL. 

The process of creating and dropping database objects. 


The set of SQL commands that create and drop database objects. 
This includes the commands to create and remove DBEEileSets, 
DBEEiles, tables, views, and indexes. Also known as DDL. 

The process of access data within a database. 


The set of SQL commands that access data. This includes the 
actions of selecting data, inserting rows, updating columns, and 
deleting rows. Also known as DML. 

A kind of data that can be stored in database tables. Valid 
types are CHARACTER, VARCHAR, INTEGER, DECIMAL, 
ELOAT, DATE, TIME, DATETIME, INTERVAL, BINARY, and 
VARBINARY. LONG varieties of BINARY and VARBINARY are 
also available. 
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DBA Authority 

DBCore 

DBECon File 

DBECreator 

DBEFile 

DBEFileSet 

DBEnvironment 

DBEUserlD 


The most powerful authority within an ALLBASE/SQL 
DBEnvironment. Includes the authority to create new objects, drop 
all existing objects, and grant or revoke all authorities for other 
users. DBA authority implies co-ownership of all objects within the 
D B Environment. 

A central component of ALLBASE/SQL that performs physical 
hie access and logging. DBCore also provides concurrency control 
through the use of isolation levels and locking. 

DBEnvironment Conhguration Eile. This contains startup 
parameters for the DBEnvironment. The contents of this hie are 
initially determined at the time you issue the START DBE NEW 
command. You can modify some of these parameters using SQLUtil, 
and you can override some of them with the START DBE command. 

The individual who issues the START DBE NEW command. Some 
maintenance operations require you to be the DBECreator. 

Eile containing data or indexes or both. A DBEEile of type TABLE 
can only contain table data; a DBEEile of type INDEX can only 
contain index data; a DBEEile of type MIXED can contain both 
table and index data. DBEEiles are operating system hies and are 
named according to the conventions of the operating system. 

Logical grouping of DBEEiles. You associate newly created DBEEiles 
with a DBEEileSet, and you specify a DBEEileSet when you create a 
table. 

A collection of hies containing one or more databases. Eiles include 
the DBECon hie (which holds startup parameters and log hie 
names); DBEEileO, which contains the system catalog; and log hies. 

A DBenvironment may also contain additional DBEEiles for table 
and index data. The DBEnvironment is the maximum scope of a 
transaction within ALLBASE/SQL. 


In HP-UX, a login name. In MPE XL, a login name and account 
name joined with the character One type of owner of database 
objects. 
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Embedded SQL 
Program 

Entity 

Explicit Locking 
Expression 

Foreign Key 

Group 

Hash Structure 

Host Variable 


An application program incorporating SQL statements for 
programmatic access to ALLBASE/SQL databases. Each embedded 
SQL statement begins with the keywords EXEC SQL. Embedded 
SQL programs are preprocessed, then compiled before execution. Eor 
most SQL commands, the preprocessor stores a section, or runtime 
version of the command, in the DBEnvironment. 

Basic subdivision of data elements in database design. Each entity is 
a thing or event about which information is kept in the database. Eor 
each entity, there is at least one attribute that uniquely identihes a 
data element as belonging to the entity. 

Locking of tables in transactions by the use of the LOCK TABLE 
command. 

specihes a value. The most common sources of values are columns in 
a table or host variables in an application program. Expressions are 
used to identify columns or rows or to dehne new values for columns. 

A column or columns in a table which have a relationship to a 
primary column or columns in a different table such that the value 
must exist in the primary key column before it can be inserted into 
the foreign key column, and it must be deleted from all foreign key 
columns before it can be deleted from the primary key column. 

Authorization group. Membership in a group is used to confer 
common ownership or common authorization for other objects 
in the DBE. You create a group explicitly, using the CREATE 
GROUP command, then you add users to it. You can then grant 
authorizations to the group or revoke authorizations from the group. 
You can also use the group name for the ownership of database 
objects. 

ALLBASE/SQL table containing rows that are stored in such a 
way as to permit fast access to specihc tuples by means of a hash 
function. A hash structure provides a method for quickly Ending a 
row by calculating its location based on the value of the hash key, 
which you specify when you create the table. 

A variable in an application program that receives data from an 
ALLBASE/SQL database (output host variable) or passes data to 
the database from the program (input host variable). 
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Implicit Locking 

Index 

Index Scan 

Integrity Constraint 

ISQL 

Isolation Level 

Join 

Key 

Key Column 


Locking of tables in transactions according to table type and 
isolation level. For example, PRIVATE tables are locked exclusively 
for all access; PUBLIC tables are locked exclusively only for write 
operations. 

A data structure that potentially speeds access to table data through 
the use of an index scan. The four types of index are: unique, 
clustering, unique and clustering, and non-unique and non-clustering. 
An index is created for one or more key columns in the table. 

A methoe of looking up each row in an index to hud its location in 
the data hie, then accessing the row in the table. This kind of access 
requires the existence of a B-tree index, which you must create. You 
do not explicitly request an index scan. Instead, SQLCore makes this 
choice if the query optimizer decides that the use of an index is the 
best way to access the data. 

A device that ensures that a database contains only valid data. Two 
types are the referential constraint and the unique constraint. 

The interactive interface to ALLBASE/SQL. ISQL is the tool you 
use for ad hoc queries as well as for loading and unloading data and 
other database administration tasks. 

The degree of separation enforced between the transactions of 
different users. There are four levels: Repeatable Read (RR), Cursor 
Stability (CS), Read Committed (RC), and Read Uncommitted 
(RU). You specify an isolation level in the BEGIN WORK command. 


A query that accesses data from two or more ALLBASE/SQL tables 
at a time. A join column is a column that occurs in both tables of 
a join (often it is a key column) and contains similar values in both 
tables. 

One or more columns on which an index, hash structure, or integrity 
constraint are based. 

A column which is indexed, or a column which participates in 
integrity constraints as all or part of a PRIMARY or FOREIGN key. 
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Key Value 
Locking 

Logging 

Message Catalog 

Message File 

Modified Source File 

Module 

Native Language 


The value contained in the columns of a key. Key values are stored in 
index pages along with pointers to the location of rows in data pages. 

A technique for concurrency control through which ALLBASE/SQL 
restricts access to data by one individual when the data is being used 
by another. Locks are of three types: shared, exclusive, or shared 
with intent to become exclusive. Lock type is determined by the 
type of table being accessed and by the kind of operation the user 
is performing. Locks are released when a transaction ends with a 
COMMIT WORK command. 

The use of log hies to record operations that modify database hies. 
Logging is of two kinds: nonarchive logging, and archive logging. 

Both kinds permit you to roll back incomplete transactions following 
a system failure. This maintains data integrity by backing out 
changes to the database that were not committed. Only archive 
logging allows you to roll forward from an earlier version of a 
DBEnvironment by reapplying all committed transactions up to a 
specihc recovery time. 

A hie containing ALLBASE/SQL error and warning messages. When 
a message is displayed, its text comes from this hie. You can look up 
the meaning of the message in the ALLBASE/SQL Message Manual. 


An error and warning hie known as SQLMSG generated by a 
preprocessor session. It contains any errors generated during the 
preprocessing of an embedded SQL program. 

The hie that results from using the preprocessor on an embedded 
SQL source hie. The modihed source hie can then be compiled into 
an executable program. 

A group of sections stored in the DBEnvironment when an embedded 
SQL program is preprocessed or when you use the PREPARE 
command in ISQL. The sections are activated when the program is 
run or when the EXECUTE command is issued in ISQL. 

The language of the DBEnvironment or of specihc CHAR and 
VARCHAR columns in a table. You specify the DBEnvironment’s 
language in the START DBE NEW command using the LANG= 
clause. In table creation, you can use the LANG= clause as part of 
a character column description. The default language is known in 
HP-UX as n-computer; in MPE XL, it is NATIVE-3000. 
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Nonarchive Logging 

Normalization 

Object 

Optimizer 

Owner 

Predicate 


Preprocessor 


Primary Key 


The default logging method. Uses log hies to roll back (that is, undo) 
incomplete transactions that were not committed at the time of a 
system failure. 

A formal process of adjusting table design in relational databases by 
examining and adjusting the relationships among columns. 

A structure created and stored in an ALLBASE/SQL 
DBEnvironment. The most common objects are tables, views, 
indexes, and groups. 

Component of SQLCore which chooses the access path in processing 
a query. In optimization, ALLBASE/SQL chooses whether to 
use serial access to the data, or whether to use an index or hash 
structure if they exist. If there is a choice among indexes, the 
optimizer calculates the best access path. 

A DBEUserlD, a group name, or a class name. Ownership applies to 
database objects such as tables, views, indexes, and authorization 
groups. The owner may drop the object or transfer it to some other 
owner. 

Part of query syntax that specihes a subset of rows to be returned in 
the query result. Predicates are introduced by the keyword WHERE, 
so they are sometimes called WHERE clauses. 

Predicates let you specify a range of values. The comparison 
predicate lets you compare a column value with a constant or host 
variable; the LIKE predicate lets you compare a column value with 
a portion of a character string; the BETWEEN predicate specihes a 
range of values for a comparison. Special predicates of various kinds 
let you search for rows in more complex ways, including the use of 
subqueries. 

A component of ALLBASE/SQL that converts an embedded SQL 
program into a modihed source hie for input to a compiler in one of 
several programming languages: C, COBOL, EORTRAN, and Pascal. 

A column in a table dehned so as to permit reference by foreign keys 
in other tables. A primary key also enforces uniqueness within the 
column. 
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Projection 

Query 

Query Language 

Query Result 
Read Committed (RC) 

Read Uncommitted (RU) 

Referential Constraint 

Relation 
Relational Qperations 

Relationship 

Repeatable Read (RR) 


Relational operation that extracts a subset of columns from a table. 


Request for information from database tables. A typical example is a 
SELECT statement. 

A set of operators, expressions, and commands that let you 
manipulate a database. The query language of ALLBASE/SQL is 
SQL. 

The rows retrieved by a SELECT statement. Query results are also 
known as result tables. 

An isolation level that guarantees only that data you read in a 
transaction has been committed by some earlier transaction; that is, 
it is not currently in the process of update by some other transaction 
at the time you are reading it. In practical terms, this means that 
another transaction can update or delete the same row before your 
transaction is over. However, concurrency is greatly improved. 

An isolation level that enforces no separation between your 
transaction and those of others, because no locks are obtained for 
reads. This level permits dirty reads, that is, reading data from the 
data buffers that has not and may never be written to the database 
at all. 

An integrity constraint that enforces a relationship between the rows 
of two tables. Any value you attempt to insert into a table that has a 
referential constraint must either be NULL or be the same as a value 
in the referenced table. 

See Table. 

Ways of extracting data from relational tables. The three primary 
relational operations are selection, projection, and joining. 

The meaningful interaction of entities in database design. 
Relationships may be one-to-one, one-to-many, or many-to-many. 

An isolation level that enforces the highest level of separation 
between the transactions of different users. This level guarantees 
that when you re-read any data you have read previously in the same 
transaction, the value seen in the second read will be the same as the 
value seen in the hrst read. In practical terms, this means that other 
users may not update any data you have read at this isolation level 
until you COMMIT WORK. 
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Result Table 
Rollback Recovery 

Rollforward Recovery 

Row 

Run Authority 

Schema 

Section 

Serial Scan 

Special Authority 


See Query Result. 


A process by which ALLBASE/SQL backs out of incomplete 
transactions using a log hie. If a DBEnvironment stops while some 
transactions are still in progress, they must be undone the next time 
the DBEnvironment starts up. 

A process by which ALLBASE/SQL reapplies transactions to a 
DBEnvironment from a log hie. Rollforward recovery requires the use 
of archive logging. 

Horizontal division within a database table. Analogous to a record in 
a hie. 

Permission to execute stored sections that perform ALLBASE/SQL 
queries or other operations from an application program. Required in 
addition to permission at the operating system level to execute the 
application itself. 

An ISQL command hie containing commands to create a 
DBEnvironment and the objects within it, such as DBEEileSets, 
DBEEiles, tables, views, indexes, and authorities. You can create a 
schema hie with an editor, or you can generate one from an existing 
DBEnvironment by using SQLGEN. 

Also, a TurboIMAGE database dehnition which is the input to the 
TurboIMAGE DBSCHEMA program. 

An SQL command stored in the DBEnvironment for use at run time 
by an application program. When sections are valid, they can be 
executed immediately by ALLBASE/SQL. When they are invalid, 
they must be revalidated at run time before execution. 

A method of reading sequentially from the start of a table until the 
row is found. Also called table or relation scan. This is the default 
scan method used to access rows in a table when indexes do not 
exist. If indexes do exist on a table, the optimizer chooses whether to 
perform an index scan or a serial scan. 

Permission to use the DBEnvironment in particular ways. 

CONNECT authority lets you establish a user session. RESOURCE 
authority lets you create and drop objects such as tables, views, 
DBEEiles, etc. DBA authority gives you permission to perform 
all SQL and SQLUtil commands, and it grants co-ownership of all 
objects in a DBEnvironment. 
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SQL 

SQLCore 

SQLGEN 

SQLMigrate 

SQLUtil 

Structured Query 
Language 

Subquery 

SYSTEM 

System Catalog 


See Structured Query Language. 


A central component of ALLBASE/SQL. SQLCore checks the syntax 
of commands and prepares them for processing. SQLCore also 
optimizes queries, that is, chooses the best access path to the data. 

A utility program for database administrators that generates 
the SQL commands necessary to re-create all or part of a 
DBEnvironment. The output from SQLGEN is a command hie 
(sometimes called a schema) that can be used as input to ISQL in 
re-creating database objects. 

A utility program for database administrators that assists in 
migrating a DBEnvironment from one version of ALLBASE/SQL to 
another without unloading and reloading data. 

A utility program for database administrators that assists with 
DBEnvironment maintenance, backup, and recovery. SQLUtil also 
lets you modify the startup parameters for a DBEnvironment. 

A standard query language syntax dehned by ANSI standards in the 
United States nad X/OPEN standards in Europe. The relational 
database query language used by ALLBASE/SQL. 


A query within another query. An example is a subquery embedded 
in the predicate of another query. The result of the inner query is 
used to evaluate the outer query. 

A DBEEileSet created by ALLBASE/SQL when you issue the 
START DBE NEW command. The DBEEile known as DBEEileO is 
associated with SYSTEM, which is the DBEEileSet containing the 
system catalog. You can add DBEEiles to SYSTEM as you would to 
any other DBEEileSet. 

Also, a special user associated with the system views in the system 
catalog. 

A system-maintained database of tables and views owned by the 
special user SYSTEM and containing information about all the 
objects in the DBEnvironment. Contains data about all the objects 
created in the DBEnvironment. Differs from the DBECon hie, which 
contains startup parameters, not object dehnitions. 
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System Table 
System View 

Table 

Table Authority 


Transaction 


Unique Constraint 
Unique Index 

Validation 


View 


See System View. 


A component view within the system catalog. You can issue queries 
on the views in the system catalog just as you would on ordinary 
database tables to display information about the DBEnvironment. 

Basic unit of data storage in a relational database. Also known as 
a relation. Tables consist of rows and columns. A result table is a 
query result displayed in tabular form. 

Permission to use specihc SQL commands on particular tables. There 
are several kinds of TABLE authority: SELECT, INSERT, DELETE, 
UPDATE, and INDEX. SELECT, INSERT, and DELETE let you 
operate on rows or sets of rows in a table; UPDATE lets you modify 
specihc rows or columns in a table; and INDEX lets you create 
indexes on a table. 

A unit of work in ALLBASE/SQL. Also, a unit of DBEnvironment 
logging and recovery. A transaction is started with a BEGIN 
WORK command and is ended by a COMMIT WORK command. 
The BEGIN WORK statement may be implicitly issued by 
ALLBASE/SQL if no other transaction is current. 


An integrity constraint which requires that no two rows in a table 
have the same values in a specihed column or columns. 

An index which requires that no two rows in a table have the same 
key value. 

The process by which ALLBASE/SQL marks a section valid in the 
system catalog. A section is marked valid if all the objects it refers to 
exist, and if it has been optimized. A valid section can be executed 
immediately at run time with no further preparation. 

a table derived by placing a “window” over one or more tables. 

The derivation of a view is a SELECT command. View names are 
governed by the same rules as table names. 
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